Dump of existing HTML tutorials into docuwiki format by the HTML::WikiConverter::DokuWiki Perl module. Useful for moving things from HTML tutes to the wiki at the SDF wiki. Convert script and source HTML also provided.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

145 lines
14 KiB

[[node8.html| {{../img/latex2html/next.png?37x24|next}}]] [[unx.html| {{../img/latex2html/up.png?26x24|up}}]] [[node6.html| {{../img/latex2html/prev.png?63x24|previous}}]] [[node1.html| {{../img/latex2html/contents.png?65x24|contents}}]] [[../|{{../img/latex2html/root.png|root}} ]]\\ ** Next:** [[node8.html|7. Programming]] ** Up:** [[unx.html|Introduction to Unix &]] ** Previous:** [[node6.html|5. Learning More]]   ** [[node1.html|Contents]]**\\ \\ [[|**Subsections**]]
* [[#SECTION00710000000000000000|6.1 Getting Information on SDF]]
* [[#SECTION00720000000000000000|6.2 COM Mode]]
* [[#SECTION00721000000000000000|6.2.1 COM Commands Discussion]]
* [[#SECTION00722000000000000000|6.2.2 COM Session Example]]
* [[#SECTION00723000000000000000|6.2.3 What to Do if You Are Caught in the Newbie Loop]]
* [[#SECTION00724000000000000000|6.2.4 COM History]]\\
* [[#SECTION00730000000000000000|6.3 Bulletin Board]]
====== [[| 6. Super Dimension Fortress]] ======
Here is some quick reference information about using [[http://sdf.lonestar.org/|Super Dimension Fortress]] (SDF). I'm not a member of SDF's staff, so the information here is not definitive. If you find a discrepancy between what I say & how things actually work on SDF, it's an error in what I've said, not in how SDF behaves.
====== [[| 6.1 Getting Information on SDF]] ======
Use the //faq// or //help// commands to get information about SDF. These are not standard unix programs. They are specific to SDF.
The //help// command mostly gives you lists of other commands. If you type ``"help"'', you'll see a menu like this:
SDF Help System - v8, 1993 - sdf!smj
[a] Directory and File Utilities
[b] Email Information
[c] USENET Information
[d] User and Process Information
[e] Tutorials and Very Useful Commands
[f] ARPA Services (internetworking)
[g] Homepage, VHOST and MetaARPA Utilities
[q] Quit SDF Help System
Your Choice?
For more help, type 'faq'
For a list of basic UNIX commands, type 'unix'
to remove your account, type 'delme'
Most of the letters in the menu will give you lists of commands. After you quit the //help// program with ``"q"'', you could run the commands or read more about them in the online manual I discussed earlier. Some of the programs are specific to SDF & are not discussed in the man. SDF's excellent //com// program is an example of a program that is not discussed in the man.
To me, the //faq// program is more useful. In it, you can find short explanations of unix file permissions, uploading & downloading, SDF's policies, & the history of SDF.
To enter the faq, type ``"faq"'' on the command line, & the //faq// program gives you a list of sections. This is faq's main menu. You can exit by typing ``"q"'' here. If you type ``"g"'', it will ask you for the name of a section. You enter a section name & press return, & you'll see the section's menu.
In a section's menu, you have a numbered list of questions or topics. If you type ``"g"'', & press return, you'll see main menu again. If you type ``"t"'', you'll be prompted for the number of a question or topic. Type that & press return. You should type the number exactly as it appears in the menu, including leading zeros.
Some things you can learn from the //faq// include:
* SDF's policies (& prices, methinks)
* brief history of unix
====== \\ 6.2 COM Mode ======
SDF has its own chat system, called "com". It's like a stripped-down IRC, but much cooler than IRC because people actually talk, & you don't get unwanted pop-up download files & you don't have tons & tons of bots waiting to download ``warez''. Anyway, "com" is like IRC except that "com" is cool.
To use com, type ``"com"'' on the command line. You'll be plopped into the lobby, which is the default room.
Com uses //single-key commands// mostly. If you are new to "com", you might want to read [[#com-command-discussion|COM Command Discussion]] in this same article. If you are having trouble exiting from the "com" program, then you definitely need to read [[#com-command-discussion|COM Command Discussion]].
Table [[node7.html#tab-com-commands|6.1]] shows the most frequently needed "com" commands.
**Table 6.1:** The most frequently needed commands for "com"
| | **key** | **meaning** | | h | Get a list of all the commands | | ? | Get a list of all the commands | | //space bar// | Enter text that you ``say'' into the room | | //return// | Enter text that you ``say'' into the room | | g | goto another room | | q | Quit COM Mode | |
Also, from COM Mode, you can compete with others in games of Nethack, Netris, & some others. If you can master the ``h'' command in COM, it will show you the commands for playing these games.
===== \\ 6.2.1 COM Commands Discussion =====
The "com" commands are //hot//. By that, I mean that you type a command character, & "com" immediately takes action. You must be careful to type only the command character you intend. If you type other characters along with the character you intend, one of those other characters might be interpreted as a command, & the character you intend will be interpreted as an argument to that command. It might sound like I'm being pedantic, but people who are new to "com" often have this problem.
Table [[node7.html#tab-proper-com|6.2]] shows the proper sequence of steps for entering a command in "com". It assumes you are already running "com" & that you are not currently processing any "com" commands. You are just reading the text in the room.
**Table 6.2:** The proper & detailed sequence of events for executing a command in "com"
| {{img3.png?537x684|\begin{table}\begin{enumerate} \item Put both hands in your lap so that neither ... ...the command key you intended, you did it incorrectly. \end{enumerate}\end{table}}} |
Step number 4 in Table [[node7.html#tab-proper-com|6.2]] is critically important &amp; deserves further discussion. In step number 4, you touch (or ``type'') the command key. You do not touch (or type) any other keys on your keyboard or on any other keyboard. You don't need to ``enter'' the command by typing the Return or Enter key on your keyboard; "com" will acknowledge your command key immediately.[[footnode.html#foot488|<sup>6.1</sup>]]
A common error for new users is to type the Return (or Enter) key after they type the command key. "Com" executes the command key fine, then it notices the Return key. Return is a command, so "com" executes it. The Return command gets you a prompt so that you may enter text that you ``say'' for other people to ``hear'' in the room. Because of the Return key, "com" is not interpreting the new user's keystrokes as commands.
Then the new user tries to type another command, such as the ``q'' (quit) command, but "com" interprets it as text to say into the room. The new user is under the impression that he needs to end commands with Return, so he does that, which causes "com" to print ``q'' into the room for everyone to see. The new user is confused about why his command doesn't execute, so he types ``h'' &amp; Return again. The ``h'' is interpreted as a command &amp; gets him a menu, but the Return is also interpreted as a command &amp; puts him into enter-a-line-of-text mode. He sees the ``q'' command in the menu, types it &amp; Return, &amp; the cycle repeats.
All of this discussion may seem silly to most people, but a lot of new users have amazingly huge amounts of trouble when they learn to enter a command into "com".[[footnode.html#foot489|<sup>6.2</sup>]]
===== [[| 6.2.2 COM Session Example]] =====
Let's walk a new user named //newbie// through his first session in "com".
- Newbie starts on the unix command line.
- Newbie enters COM Mode by typing ``"com"'' &amp; pressing the Return key.
- Newbie might have to wait a few seconds, but she eventually sees "com" start. (I think new users see a menu of the "com" commands &amp; have to answer Yes that they have read &amp; understood the menu.) After "com" starts, Newbie will be in the //lobby// &amp; will see a list of the people in that room. (The lobby is the default room &amp; is where most of the chatting happens.)
- Newbie wants to say hello to everyone, so she types the Space Bar &amp; waits until she sees a ``"[newbie]"'' prompt. Then Newbie types ``Hi all. I'm new.'' &amp; then types the Return key.
- Everyone in the room will see ``"[newbie] Hi all. I'm new."''.
- //Newbie is doing well so far, but now let's have her make a mistake.//
- Newbie wants to leave "com", but she can't remember the command, so she types ``h'' to get a menu &amp; pressed Return. //This was a mistake. Newbie should have typed ``h'' alone &amp; not pressed Return.//
- //"Com" sees Newbie's ``h'' command &amp; prints the help menu. That's good, but "com" also sees Newbies Return &amp; assumes Newbie wants to ``say'' a line of text into the room. So "com" prints a ``"[newbie]"'' prompt &amp; waits for Newbie to type some text, but Newbie is busy reading the help menu &amp; doesn't notice the prompt.//
- Newbie sees the ``q'' (quit) command on the help menu &amp; types ``q'' &amp; then Return. //This is a double mistake. "Com" thinks Newbie is typing a line of text to say into the room, so her ``q'' is not interpreted as a command. Also, Newbie is still under the incorrect belief that she must end "com" commands with a Return.//
- Because of Newbie's mistake in the previous step, "com" prints ``"[newbie] q"'' into the room.
- Newbie is confused that her ``q'' command didn't work, so she types ``h'' &amp; Return. This takes her back to step 7. She'll repeat this who knows how many times. Other people in the lobby will notice her problem &amp; try to help, but Newbie has to go through the error many times before she stops typing Return after her commands.The problem is compounded by "com"'s modality &amp; Newbie's failure to realize that "com" is modal. Sometimes, "com" is waiting for Newbie to type a command. Some commands are single key. (The ``q'' &amp; ``h'' commands are examples.) Other commands wait for Newbie to type something, &amp; during that time, "com" does not interpret her keystrokes as commands. (The Space Bar and Return commands, both of which are for saying text into the room, are examples.)The other people in the room see what Newbie is going through, but there isn't much they can do because they can't see Newbie's screen &amp; help her figure out whether "com" is waiting for her to type a command or waiting for her to type text. What's more, whenever they say something like ``Type //h// by itself'', Newbie types an ``h'' &amp; then a Return. So Newbie keeps going around &amp; around.
- Eventually, Newbie figures it out while "com" is waiting for her to type a command. At this time, Newbie types ``q'' (&amp; does not type any other characters at all).
- Newbie might have to wait a few seconds, but she eventually sees "com" print an ``Unlinking tty'' message, &amp; then Newbie is dropped back into her unix command line.
===== [[| 6.2.3 What to Do if You Are Caught in the Newbie Loop]] =====
The problem is that "com" is modal &amp; new users sometimes fail to realize that.
What does it mean for a program to be **modal**? It means that sometimes, "com" is waiting for you to type a command, &amp; sometimes it is waiting for you to type arguments to a command. Some commands are single key. (The ``q'' &amp; ``h'' commands are examples.) Other commands wait for you to type something, &amp; during that time, "com" does not interpret her keystrokes as commands. (The Space Bar and Return commands, both of which are for saying text into the room, are examples.)
If you find yourself in the "Com" Newbie loop, here's how to get out of it. Follow the exact steps from Table [[node7.html#tab-exit-newbie-loop|6.3]]. Type only what it says to type. Do not type anything else. Do not type Return unless a step in the table says to type Return.
**Table 6.3:** The steps to get out of the "Com" Newbie loop. Do exactly what the steps say. Do only what the steps say. Do not type anything else.
| {{img4.png?534x194|\begin{table}\begin{enumerate} \item Type the Space Bar. \item Type the Return (... ...u may now re-enter {\tt com} or go do something else. \end{enumerate}\end{table}}} |
Here's why the steps in Table [[node7.html#tab-exit-newbie-loop|6.3]] work:
- If "com" is waiting for you to type a command, then you could type the command anyway, but you type Space, which gets you a prompt ("com" isn't interpreting commands). Then you type Return, which ends that prompt. So now "com" is waiting for a command again. So the Space Bar &amp; Return sequence was unnecessary, but it did not harm. (People in the room won't even see it because if you try to ``say'' an empty line, "com" doesn't print anything.)
- If "com" has prompted you &amp; is not interpreting your commands, the Space Bar won't do anything useful, but the Return key will end that prompt. If you had mistakenly typed Return earlier &amp; "com" was waiting for you to say something into the room, the Space Bar will do nothing, but the Return will end that mode, &amp; "com" will now wait for you to type a command.. (If you had typed things before the Space Bar, you will ``say'' them into the room.)
===== [[| 6.2.4 COM History]] =====
I have heard that early versions of COM Mode were fairly simple shell scripts that ran //tail// on a common file. Excellently unixly elegant. COM Mode is in about version 6 now, &amp; it works across a bunch of computers networked at SDF, so I don't know if it's still just some shell scripts.
====== [[| 6.3 Bulletin Board]] ======
If you type ``"bboard"'', you'll enter the bulletin board. Its commands resemble those of the //faq//:
**g**Prompts you for a section name, which you type. Then takes you to that section. **t**From a section's menu, prompts you for a message number (which you must enter exactly, including leading zeros). Then it prints the message &amp; all replies to your screen. **q**Quits the bulletin board.
[[node8.html| {{../img/latex2html/next.png?37x24|next}}]] [[unx.html| {{../img/latex2html/up.png?26x24|up}}]] [[node6.html| {{../img/latex2html/prev.png?63x24|previous}}]] [[node1.html| {{../img/latex2html/contents.png?65x24|contents}}]] [[../|{{../img/latex2html/root.png|root}} ]]\\ ** Next:** [[node8.html|7. Programming]] ** Up:** [[unx.html|Introduction to Unix &amp;]] ** Previous:** [[node6.html|5. Learning More]]   ** [[node1.html|Contents]]**
Gene Michael Stover 2005-07-07