home *** CD-ROM | disk | FTP | other *** search
/ ftp.pasteur.org/FAQ/ / ftp-pasteur-org-FAQ.zip / FAQ / unix-faq / shell / intro < prev    next >
Encoding:
Internet Message Format  |  2004-05-12  |  10.1 KB

  1. Path: senator-bedfellow.mit.edu!dreaderd!not-for-mail
  2. Message-ID: <unix-faq/shell/intro_1084272547@rtfm.mit.edu>
  3. Supersedes: <unix-faq/shell/intro_1083581613@rtfm.mit.edu>
  4. Expires: 1 Jun 2004 10:49:07 GMT
  5. X-Last-Updated: 1996/06/11
  6. From: tmatimar@isgtec.com (Ted Timar)
  7. Distribution: world
  8. Newsgroups: comp.unix.shell,news.answers,comp.answers
  9. Followup-To: comp.unix.shell
  10. Organization: ISG Technologies Inc
  11. Subject: Welcome to comp.unix.shell [Frequent posting]
  12. Approved: news-answers-request@MIT.Edu
  13. Originator: faqserv@penguin-lust.MIT.EDU
  14. Date: 11 May 2004 10:50:02 GMT
  15. Lines: 206
  16. NNTP-Posting-Host: penguin-lust.mit.edu
  17. X-Trace: 1084272602 senator-bedfellow.mit.edu 574 18.181.0.29
  18. Xref: senator-bedfellow.mit.edu comp.unix.shell:165518 news.answers:271077 comp.answers:57121
  19.  
  20. Archive-name: unix-faq/shell/intro
  21. Version: $Id: intro,v 2.4 1995/03/28 14:14:12 tmatimar Exp $
  22.  
  23. This article is a monthly attempt to remind potential posters about
  24. what is appropriate for comp.unix.shell.  If you would like to make
  25. any suggestions about the content of this article, please contact
  26. its maintainer at tmatimar@isgtec.com.
  27.  
  28. Many FAQs, including this one, are available on the archive site
  29. rtfm.mit.edu in the directory pub/usenet/news.answers.
  30. The name under which a FAQ is archived appears in the "Archive-Name:"
  31. line at the top of the article.  This FAQ is archived as
  32. "unix-faq/shell/intro".
  33.  
  34. Companion articles include the answers to some Frequently
  35. Asked Questions.  You may save yourself a lot of time by reading
  36. those articles before posting a question to the net.
  37.  
  38. If you have not already read the overall Usenet introductory material
  39. posted to "news.announce.newusers", please do.  Much of this article
  40. overlaps with the common sense guidelines posted there.
  41.  
  42.          Should I Post My Shell Question to the Net?
  43.  
  44. Often the answer is "No, you can get an answer a lot faster without
  45. posting a question." Before you post, you should try -
  46.  
  47.     o Reading the manual for your system.  Some day you may encounter
  48.       the phrase "RTFM", which stands for "Read the Fine Manual"
  49.       (except 'F' doesn't really stand for "Fine").  If you ask
  50.       someone a question and they tell you to RTFM, it's an
  51.       indication that you haven't done your homework.  For instance,
  52.       if you are trying to make a script run under csh instead of sh,
  53.       check the man page for "csh".  It might tell you what you need
  54.       to know.
  55.  
  56.       When people use terminology like "read(2)", they are referring
  57.       to the "read" man page in section 2 of the manual (which you
  58.       would see by using "man 2 read").
  59.  
  60.     o Finding a knowledgeable user at your site.  Many sites have
  61.       at least a few shell experts who will be happy to help you
  62.       figure out how to specify that a script should be run by csh.
  63.       Many larger sites, particularly universities, may even have
  64.       paid consultants whose job is to help you with these problems.
  65.       Check with them first.
  66.  
  67.     o Find a good introductory book on Unix shells and shell programming.
  68.       There are plenty of such books available, and you will save yourself
  69.       a lot of trouble by having one handy and consulting it frequently.
  70.       (Question 1.5 in the companion articles will let you know
  71.        where you can find a list of good books.)
  72.  
  73. Please remember that the comp.unix.* newsgroups are read by over 80,000
  74. people around the world, and that posting a question to this group will
  75. cost a lot of time and money by the time your article is distributed to
  76. Asia, Australia, Europe (west and east), Africa, the middle east,
  77. all corners of North, South and Central America and even Antarctica.
  78.  
  79. Also, some people receive these newsgroups as part of a mailing list
  80. rather than a newsgroup.  If you're one of these people, please don't
  81. send a "Remove me from this list" or "UNSUBSCRIBE"  message to the
  82. wrong place.  Take the time to figure out where you're getting this
  83. stuff from, and send your request to the mailing list maintainer, *not*
  84. to the list or newsgroup itself!  Ask your local postmaster for help.
  85. (One of the answers in the companion articles deals with the details of
  86. the mailing list.)
  87.  
  88.                To Which Newsgroup Should I Post My Question?
  89.  
  90. The choice of newsgroup is harder than it used to be.  In the old days,
  91. you just had to choose between "comp.unix.questions" and
  92. "comp.unix.wizards".  Now there are a variety of more specific groups.
  93. This group, "comp.unix.shell" is only for questions relating to any of
  94. the Unix shells and shell programing.  Other groups each have their own
  95. mandates.
  96.  
  97. Choose one of the following groups carefully.  If you aren't sure where
  98. your question belongs or if your question is not specific to some
  99. particular version of Unix, try "comp.unix.questions".  Many
  100. knowledgeable Unix wizards read that group and will be able to help you.
  101.  
  102. Here are the capsule descriptions of various groups you might consider
  103. (extracted from a monthly posting to "news.announce.newusers")
  104.  
  105. comp.unix.shell         Using and programming any UNIX shell.
  106.  
  107. comp.unix.questions     General questions from UNIX users and sysadmins.
  108.             If your question isn't a really good match for one of
  109.             the groups below, post it here.
  110.  
  111. news.answers        Repository for periodic USENET articles. (Moderated)
  112.             This article is crossposted there.
  113.             Do not try to post here unless you're
  114.             posting a list of FAQ's and their answers.
  115.  
  116. comp.lang.c             Discussion about C.
  117.  
  118. comp.sources.unix       Postings of complete, UNIX-oriented sources. (Moderated)
  119. comp.std.unix           Discussion for the P1003 committee on UNIX. (Moderated)
  120. comp.unix.admin         Administering a Unix-based system.
  121. comp.unix.aix           IBM's version of UNIX.
  122. comp.unix.amiga        Unix on the Commodore Amiga
  123. comp.unix.aux           The version of UNIX for Apple Macintosh II computers.
  124. comp.unix.bsd           Discussions relating to BSD UNIX.
  125. comp.unix.internals     Discussions on hacking UNIX internals.
  126. comp.unix.large         UNIX on mainframes and in large networks.
  127. comp.unix.misc          Various topics that don't fit other groups.
  128. comp.unix.programmer    Q&A for people programming under Unix.
  129. comp.unix.ultrix        Discussions about DEC's Ultrix.
  130. comp.unix.xenix.misc    General discussions regarding XENIX (except SCO).
  131. comp.unix.xenix.sco     XENIX versions from the Santa Cruz Operation.
  132. comp.os.linux.*         Discussion about Linux ...
  133. comp.lang.perl          Discussion about Perl
  134.  
  135. comp.unix.wizards       In-depth discussions of advanced unix topics.
  136.             People should not post to this group unless they
  137.             have used unix as a user, sysadmin and know details
  138.             of the kernel, and how different unix kernels differ.
  139.             In other words, don't post to comp.unix.wizards.
  140.  
  141.           What Information Should I Include?
  142.  
  143. It's hard to include too much information.  There are hundreds of
  144. different systems out there, and they all have less in common
  145. than you might think.  If you have a problem and are posting an
  146. article, please be sure to mention:
  147.  
  148.     o A descriptive subject line.  Many people will decide whether
  149.       to read your article solely on the basis of the subject line,
  150.       so it should be a good statement of your problem.
  151.  
  152.       NOT GOOD                          GOOD
  153.  
  154.       "Help"                            "How do I port csh scripts to ksh?"
  155.       "Csh question"            "csh dumps core when I use '$<'"
  156.  
  157.     o What computer you are using, what specific version of the
  158.       operating system it uses, and to what shell the question
  159.       pertains.  For instance,
  160.  
  161.         SunOS 4.0.1, Sun 3/50, tcsh 6.00.03
  162.         4.3BSD-tahoe, Vax 11/780, rc 1.0
  163.         SVR3.2, 3b2, sh 4.2
  164.  
  165.     o If possible, the *exact* text of any error message you
  166.       may have encountered.
  167.  
  168.       WRONG                RIGHT
  169.  
  170.       "My csh script doesn't run"    "When I type 'scriptname', I get
  171.                       sh: scriptname: This isn't a shell script.
  172.                       What does this mean?  It isn't in
  173.                       the man page.  This is using crash 3.14
  174.                       under Mueslix 9.3 on a Fax 68086502"
  175.  
  176. It's a good idea to post unrelated questions in separate articles,
  177. so that people can keep different discussions separate.   It's also
  178. a *very* good idea to include a line or two like this:
  179.  
  180.     "Please mail your answers to me and I'll summarize what I get
  181.      and post the results to comp.unix.shell."
  182.  
  183. This prevents many identical responses from different users to the
  184. same question from clogging up the newsgroup.  And make sure
  185. you really summarize what you get - don't just concatenate
  186. all the mail you've received.
  187.  
  188. It's also a good idea to read comp.unix.shell for at least a couple
  189. of weeks after you post your article to see what followup articles
  190. are posted.
  191.  
  192.                 Should I Post an Answer to a Question?
  193.  
  194. It's very tempting to post an answer to a question you read on the net,
  195. especially when you think "Aha, finally - a question I can answer!"
  196. Consider though that when a simple question is asked, such as the
  197. sort answered in the companion articles, many other people around the
  198. world already know the answer and may be posting their own reply.
  199. In order to avoid dozens of replies to simple questions, please
  200. wait a day or so and see if anyone else has already answered
  201. the question.  If you have something special to contribute, please
  202. do so, but make sure you're not duplicating something someone else has
  203. already done.
  204.  
  205. You should feel free to reply to any question >by email<.  Even if
  206. the user gets 200 responses to his question, at least the load on the
  207. rest of the net is minimized.
  208.  
  209.                     What About Posting Source Code?
  210.  
  211. Posting small amounts of example code is fine (use comp.sources.unix to
  212. distribute complete programs) - but please make sure that your code
  213. runs (or at least compiles) properly.  Don't just type it in while
  214. editing your posting and hope it will work, no matter how sure you are
  215. that it will.  We all make mistakes.
  216.  
  217.                         What About Those People
  218.        Who Continue to Ask Stupid or Frequently Asked Questions
  219.          In Spite of The Frequently Asked Questions Document?
  220.  
  221. Just send them a polite mail message, possibly referring them to this document.
  222. There is no need to flame them on the net - it's busy enough as it is.
  223. -- 
  224. Ted Timar - tmatimar@isgtec.com
  225. ISG Technologies Inc, 6509 Airport Rd., Mississauga, Ont., Canada L4V 1S7
  226.