You are not logged in. Login Now
 0-24   25-49         
 
Author Message
danr
Grex Manual Outline (65 lines) Mark Unseen   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: Mark Unseen   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: Mark Unseen   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: Mark Unseen   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: Mark Unseen   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: Mark Unseen   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: Mark Unseen   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: Mark Unseen   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: Mark Unseen   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: Mark Unseen   Jun 1 01:58 UTC 1995

Yes. I'll download these suggestions and come up with a revised outline.
popcorn
response 10 of 49: Mark Unseen   Jun 1 15:26 UTC 1995

(that's /usr/local/inet, near the end of #7, not "loccal")
danr
response 11 of 49: Mark Unseen   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: Mark Unseen   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: Mark Unseen   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: Mark Unseen   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: Mark Unseen   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: Mark Unseen   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: Mark Unseen   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: Mark Unseen   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: Mark Unseen   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: Mark Unseen   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: Mark Unseen   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: Mark Unseen   Jun 4 13:56 UTC 1995

re 15: What's C-h, in plain ascii?  Control-H?
remmers
response 23 of 49: Mark Unseen   Jun 5 22:10 UTC 1995

Yes.
sarrica
response 24 of 49: Mark Unseen   Jun 9 01:37 UTC 1995

I *like* "The Joy of Grex"-- it's much better than my first idea,
"Grex on Dead Trees".
 0-24   25-49         
Response Not Possible: You are Not Logged In
 

- Backtalk version 1.3.30 - Copyright 1996-2006, Jan Wolter and Steve Weiss