Stein Gjoen's Home Page

Linux Documents | MOO Mystery Tour | Misc | Colophon

Note that prototyping work for the Linux Documentation Project is moved to The unofficial Linux Documentation Project Advanced Research and Prototyping Laboratory.


Linux Documents

My main project here are my contributions to the Linux Documentation Project on how best to utilize a system with multiple disks for reliability, speed and convenience and also how to stay up to date with the development. This is the home page for them, look here for the latest versions.

Announcement Proposals

For some reason I have ended up writing a few proposed announcements for the LDP, including an announcement for news:comp.os.linux.announce as well as the first in what I hope will be a series of news in short on LDP activity for Linux Weekly News (LWN). Latest submission in preparation is LWN entry 4. Entries are now based on a dedicated template.

Due to increased workload I am no longer able to spend the time required to post updated news, so this task has now been taken over by other member of the LDP who now write the LDP Weekly News and also maintains an archive.

Update 2006-12-28: The weekly news writing has gone quiet recently and I therefore wrote the December issue (plain text) to restart the writing.

Introduction Proposals

Unfortunately the LDP archives are not very well know, not even that most distributions include a copy under /usr/doc/HOWTO/ for most distributions (using FSSTND) or /usr/share/doc/HOWTO/ for some recent distributions (using FHS). I have therefore proposed including an intro(ldp) man page that will easily show up when using man -k <some keyword> when people are looking for more general help. The nroff source is also available.

NetHelp Proposals

Some time ago I proposed using NetHelp as the preferred reader platform for graphical platforms but little feedback came out of it either way. I therefore made a test case by converting the Updated Mini-HOWTO into the NetHelp format. If you have Netscape Navigator you could try it out by first download the zip archive, read the readme file and unpack the files AND the directory in the NetHelp directory on your computer and then start with this URL. Note that you will need to turn on JavaScript to make it work.

If you just wish to take a look I have put up a screenshot (in PNG format) showing the contents list in the left column and the contents itself in large main window. Here is a screenshot (in PNG format) in the index mode, showing list of indexed words in the left column. clicking any of these presents a list in the main window of topics that match the index word.

Multi Disk HOWTO

The latest draft of Multi Disk HOWTO for Linux is available as

Stub man pages for HOWTOs are under development, and you can see the rendered Disk-HOWTO(ldp) or just the nroff source.

You might also find the Linux Filesystem Structure Standard and the related FAQ useful. FHS now also has an open homepage with even more documentation.

Updated Mini-HOWTO

A new HOWTO is ready, please have a look (HTML version). It is also available as text as well as SGML. It is now part of the LDP and is also available in a number of languages.

Link Checking Micro-HOWTO

A new HOWTO is ready, please have a look (plain ascii version).

Big HOWTO Template

On request I have extracted the skeleton structure of my Multi Disk HOWTO and turned it into a simple but hopefully logically complete template for aspiring HOWTO authors.

Have a look at the sample HTML file and then download the SGML file.

Minimal HOWTO Template

From the Big HOWTO Template I have extracted what I believe is the very minimum of what a HOWTO has to contain, such as name, email addres, abstract etc.

Have a look at the resulting HTML file and then download the SGML file.

Application Note proposal

In the ongoing debate on how best to organize and index documents I have proposed writing Application Notes, making it easier to navigate for people who have a specific task to do and are looking for the best solution and how to achieve it. My proposal has been submitted in the form of a sample Storage Application Note which intends to demonstrate how Linux can serve and refers to other LDP works for details.

LDP File Hierarchy Standard

This proposal attempts to define file hierarchy and contents for organising LDP documents making it possible to integrate the document base and also refer to externally created documents. Latest issue is available here

The LDP Generator

This is a prototype web interface tool for various publishers to generate a customised download based on the very latest snapshot of the LDP archive. While the backend is not implemented the tool is ready for a quick test here.

The LDP HOWTO GENERATOR

This is a working tool that helps the beginners get the tags in place while keeping the structure reasoanble intact and also give a minimum of editing as afforded by the browser used. The Generator is now validated with real input that generated this SGML output that was checked with the LinuxDoc toolchain and generated this HTML output using the command line
sgml2html --split=0 HowtoGenTest.sgml > HowtoGenTest.html
The generator used is here.

MOO Mystery tour - get your ticket here

There has been a little interest both on nyx and in the mystery newsgroup for more interactive mysteries, and in actual fact one such does exist, and has been around for a while even. The simpest way is if you have Tinifugue, a MOO client. Then you just need this little configuration file. Load it in but make first sure you do not overwrite any previous .tfrc file you may have. Note that some browsers will not allow you to save a file with a name with a leading dot, in that case rename and save before you rename the file to .tfrc to get the dot back in again. When you start up tf it will connect you to lambdaMOO and you will be prompted for starting up a session: type connect guest or help.
Then there is a little legalese, read through and answer yes or no.
Finally you will be asked where to start, answer quiet or noisy.
Have a wander around to familiarise yourself with the place, the people and the commands. You can type help to get help on lambdaMOO commands and /help to get help on Tinifugue. Then, when you feel ready to start your adventure you simply type /mystery to start up a macro defined in your .tfrc file and you are transported to the scene of the crime. After you are finished (or give up) you type @quit to close your connection and /quit to leave Tinyfugue. The solution? I do not know but supposedly you can discover it yourself in the best traditions of a whodunnit. For more information you can check out what the author (Judy Malloy) wrote some time ago. Good luck, you will need it.


Misc

The Nyx logo is now also available in text format for all you Lynx users out there.

If you program DSP56xxx chips from Motorola, you might find it useful to write the assembly souce in Ultraedit with this wordfile.txt that I have made.


Colophon

Disclaimer: This document in no way represents Nyx Net. All opinions and errors are mine alone.
sgjoen@mail.nyx.net