|
Grex > Coop7 > #56: Grex Manual Outline (65 lines) | |
|
| Author |
Message |
danr
|
|
Grex Manual Outline (65 lines)
|
May 29 15:30 UTC 1995 |
Here's my current outline for the Grex manual. I'm wide open to
suggestions for additions and deletions. It also needs a snappy
title. Any suggestions for that?
Snappy Title
Chapter 1. What is Grex?
1. A Short History
2. The Grex Charter
3. Becoming a Member
Chapter 2. Getting Started
1. What equipment do you need?
2. Calling the System
3. Becoming a User: Running the newuser program
1. bbs shell
2. lynx shell
3. Unix shells
Chapter 3. Conferencing
1. Basic Introduction to PicoSpan
2. Using PicoSpan
1. Conference/item/response hierarchy
2. Basic commands: read, respond, forget, enter, scan,
browse, join, stop, display, exit, help
3. Advanced commands: find, remember, expurgate,
scribble, pseudo, source
4. bbsed
5. pagers
3. Conferencing Etiquette
4. Introduction to other features
5. customizing .login, .profile, .cfonce
6. Fairwitnessing
Chapter 4. Sending and Receiving E-Mail
1. mail
2. elm
3. pine
Chapter 5. Other Fun Stuff
1. games
2. party
3. write
Chapter 6. UNIX for Grexers
1. Basic file handling (ls, rm, cat, chmod, ln, mv, cd,
pathnames?)
2. Editor Basics
1. bbsed
2. vi
3. pico
3. Miscellaneous: last, ps, etc.
4. Pointers to better reference books
Chapter 7. Usenet News
Chapter 8. Internet Services
1. telnet
2. ftp
3. WWW
1. lynx
2. making your own home page
Appendix: Cyberspace Communications Bylaws
.
|
| 49 responses total. |
srw
|
|
response 1 of 49:
|
May 29 16:09 UTC 1995 |
Chapter 2, section 3, suggested addition: Menu shell
CHapter 3, section 5, do .login and .profile belong in this chapter?
Chapter 4, suggest the need for an etiquette section for email
Chapter 6, section 2, emacs
(you might relegate both emacs and vi to a 'unix experts' subsection)
Other things that you might want -
editing your .plan file
changing your full name/password
terminal emulation
|
mju
|
|
response 2 of 49:
|
May 29 17:47 UTC 1995 |
Chapter 2: might want to include something on accessing Grex over
the Internet, how to find an ISP in your area, etc.
Chapter 4: a section on MH would be nice.
Chapter 5: don't forget talk/ntalk/ytalk!
|
remmers
|
|
response 3 of 49:
|
May 30 00:05 UTC 1995 |
The Joy of Grex
(er, well, maybe that needs more thought...)
I'll critique the outline when I've got more time. Just breezing
through at the moment/
|
mta
|
|
response 4 of 49:
|
May 30 02:04 UTC 1995 |
Unless of course I should have finished reading the cf before sticking
my nose in. (Sounds like you've claimed it, Dan.
|
rcurl
|
|
response 5 of 49:
|
May 30 07:35 UTC 1995 |
directory "roadmap"; .cflist; .cfidir; terminal emulations;
shelling;...(just a few more topics, in no particular order).
|
peacefrg
|
|
response 6 of 49:
|
May 31 00:22 UTC 1995 |
Could this help manual be like a menu instead of like the man pages.
So you could juust tyope in the number you wanted?
|
popcorn
|
|
response 7 of 49:
|
May 31 12:18 UTC 1995 |
I think it's going to be printed, James, not necessarily on-line.
More suggestions for the outline:
Chapter 3: include the "postpone" and "new" commands. Why cover bbsed
(and only bbsed) here? Most newbies are configured to use pico these days.
Chapter 5: maybe include a figlet section? and maybe mathom? party?
Chapter 6: maybe include joe along with the other text editors? It's
easy to use and more powerful than pico. Include the "man" command here,
so users know where to get more information?
Chapter 8: maybe include some stuff from the internet conference, eg.
netfind, archie, veronica; pointers to the text files in the
/usr/loccal/inet directory (those are lists of ftp sites, etc).
This is going to be really cool, Dan. Thanks for doing this!
|
steve
|
|
response 8 of 49:
|
May 31 13:44 UTC 1995 |
Can we make a new chapter outline that includes the changes
that you incorporate Dan? I'm getting confused. ;-)
|
danr
|
|
response 9 of 49:
|
Jun 1 01:58 UTC 1995 |
Yes. I'll download these suggestions and come up with a revised outline.
|
popcorn
|
|
response 10 of 49:
|
Jun 1 15:26 UTC 1995 |
(that's /usr/local/inet, near the end of #7, not "loccal")
|
danr
|
|
response 11 of 49:
|
Jun 2 15:12 UTC 1995 |
OK, here's a new version of the outline. Thanks for all the
suggestions.
Here are also some comments about your comments.
- It may just be me, but I think vi is more widely used than
emacs and deserves some coverage in the manual. emacs is truly
for experts and way too complicated to cover except to mention
that it exists and then quickly point those interested to other
sources.
- How many people actually want or need to use mh?
- That's interesting that most new users are now using pico.
When I first started work on this outline we didn't even have
pico on Grex.
- The Internet chapter is going to be one of the hardest to
decide what to include and what to leave out. This isn't an
Internet manual after all.
- I've added a chapter titled, "Getting Help" Suggestions for
what to include here would be appreciated.
Snappy Title (still missing)
1. What is Grex?
1. A Short History
2. The Grex Charter
3. Becoming a Member
2. Getting Started
1. What equipment do you need?
2. What's Terminal Emulation?
3. Getting to Grex
1. dial-in
2. Internet
4. Becoming a User: Running the newuser program
1. bbs shell
2. menu shell
3. lynx shell
4. Unix shells
3. Conferencing
1. Basic Introduction to PicoSpan
2. Using PicoSpan
1. Conference/item/response hierarchy
2. Basic commands: read, respond, forget, postpone,
new, enter, scan, browse, join, stop, display, exit,
help
3. Advanced commands: find, remember, expurgate,
scribble, pseudo, source
4. Editors
5. Pagers
3. Conferencing Etiquette
4. Introduction to other features
5. Customizing Picospan
1. .cflist, .cfonce, .cfdir
2. rseps, iseps
3. other stuff??
6. Fairwitnessing
4. Sending and Receiving E-Mail
1. mail
2. elm
3. pine
4. E-mail Etiquette
5. Other Fun Stuff
1. write
2. party
3. talk/ntalk/ytalk
4. mathom
5. figlets
6. games
6. Getting Help
1. write help
2. send mail to ????
3. call ???
7. UNIX for Grexers
1. Basic file handling (ls, rm, cat, chmod, ln, mv, cd,
pathnames?)
2. Editor Basics
1. bbsed
2. pico
3. joe??
4. vi
3. Miscellaneous: last, ps, etc.
4. Pointers to better reference books
8. Usenet News
9. Internet Services
1. telnet
2. ftp
3. WWW
1. lynx
2. making your home page
10. Appendix: Cyberspace Communications Bylaws
|
popcorn
|
|
response 12 of 49:
|
Jun 2 15:48 UTC 1995 |
I'd add the info conference to the "getting help" section.
(Even if the conf is awfully huge right now.)
|
popcorn
|
|
response 13 of 49:
|
Jun 2 15:49 UTC 1995 |
Oh, also, I think "figlet" is singular, not plural.
BTW -- the outline looks *really* good!!
|
remmers
|
|
response 14 of 49:
|
Jun 2 16:36 UTC 1995 |
Re #11 re mh: I use mh and think it's great. But I know of only
one other grexer who uses it. There may be more, but that's not
enough to justify devoting a lot of space to it in the manual.
I'd suggest another appendix, devoted to brief mention of programs
available on grex but not covered in the main text, with pointers
to further documentation on those programs. That would be the
place to talk about mh.
|
mju
|
|
response 15 of 49:
|
Jun 2 17:05 UTC 1995 |
I would argue that Emacs is actually easier to use than vi, due to the
fact that it is modeless, and that most newusers have probably not
encountered an editor with multiple modes before. Emacs *is* a lot
more complex than vi, but most of the complexity can be ignored for
the new user. There are really only a few Emacs commands you have to
know in order to use it -- cursor up/down/left/right, backspace, and
exit. Then there are a few more that make Emacs a lot easier to use
-- beginning/end of line, delete character at cursor (C-d), delete to
end of line (C-k), yank last deletion (C-y), and forward/backward
screenful (C-v/M-v). You could also include some stuff on regions
(set mark, kill region, etc.). And, of course, you should include how
to access the on-line help (C-h). You might want to look at the Emacs
tutorial for more (start Emacs, then press C-h followed by t).
|
remmers
|
|
response 16 of 49:
|
Jun 2 21:18 UTC 1995 |
One concern I'd have about the manual is obsolesence. Pico is now the
most popular editor with newusers, but three years ago we didn't even
run it. We didn't have the menu shell back then either. So had the
manual been published three years ago, it wouldn't have mentioned a
couple of Grex's most popular programs. Are you prepared to come out
with revised editions as the system changes?
|
curby
|
|
response 17 of 49:
|
Jun 3 00:22 UTC 1995 |
Emacs is a system hog. Even though it is a very intelligent editor, on
a system like grex, where it takes at least one full second to see
what you are typing (read load is extremely high), I think that it
would be criminal (I like that word!) to advocate the use of emacs by
the masses...
(Forgive me if I just started a religious war...)
'Sides mju, not everyone has root to "nice" their editor to a
reasonable level. Not saying that you would do that of course...
<grin>
|
mju
|
|
response 18 of 49:
|
Jun 3 03:27 UTC 1995 |
I've actually never noticed that Emacs is any less responsive
than vi. Besides, what good does it do to renice your processes
when the main resource you're competing for is the Internet link?
|
danr
|
|
response 19 of 49:
|
Jun 3 03:47 UTC 1995 |
The manual would have to be revised occasionally, as many technical
publications do. Revisions are much easier than getting the thing
done in the first place. And if I decide not to update it, Cyberspace
will own the copyright and can do it themselves.
|
davel
|
|
response 20 of 49:
|
Jun 3 21:48 UTC 1995 |
For a snappy title I'd suggest (for reasons too obscure to mention):
_Take Me To Your Modem_. 8-{)}
|
curby
|
|
response 21 of 49:
|
Jun 4 10:18 UTC 1995 |
[ Re#18: Agreed, inet link is the bottle neck, but for religious ]
[ reasons, I can't agree about the emacs statement. <grin> ]
|
popcorn
|
|
response 22 of 49:
|
Jun 4 13:56 UTC 1995 |
re 15: What's C-h, in plain ascii? Control-H?
|
remmers
|
|
response 23 of 49:
|
Jun 5 22:10 UTC 1995 |
Yes.
|
sarrica
|
|
response 24 of 49:
|
Jun 9 01:37 UTC 1995 |
I *like* "The Joy of Grex"-- it's much better than my first idea,
"Grex on Dead Trees".
|