Regenerate FAQ and WishList, and update Makefile.ADMIN a bit.

Update RELEASE-PROCEDURE regarding tar.gz file naming.

Author: suominen

FAQ

@@ -11,7 +11,12 @@
    be able to get ftp it... :-)
      _________________________________________________________________
 
-   1. Why is the meta key broken in tcsh-5.20 and up?
+   1. Where can I find tcsh sources?
+
+   See http://www.tcsh.org/MostRecentRelease for download locations.
+     _________________________________________________________________
+
+   2. Why is the meta key broken in tcsh-5.20 and up?
 
    On  some  machines  the  tty is not set up to pass 8 bit characters by
    default.  Tcsh 5.19 used to try to determine if pass8 should be set by
@@ -40,7 +45,7 @@
    printable meta characters for commands) setenv NOREBIND.
      _________________________________________________________________
 
-   2.  I  ran 'dbxtool &' and 'shelltool &' from tcsh, and they end up in
+   3.  I  ran 'dbxtool &' and 'shelltool &' from tcsh, and they end up in
    cbreak and no echo mode?
 
    These  programs  are broken. Background jobs should not try to look at
@@ -56,19 +61,19 @@
    in your .dbxinit
      _________________________________________________________________
 
-   3. I tried to compile tcsh and it cannot find <locale.h>?
+   4. I tried to compile tcsh and it cannot find <locale.h>?
 
    Your  system  does  not support NLS. Undefine NLS in config_f.h and it
    should work fine.
      _________________________________________________________________
 
-   4. Where can I get csh sources?
+   5. Where can I get csh sources?
 
    Csh   sources   are   now   available   with   the  4.4BSD  networking
    distributions. You don't need csh sources to compile tcsh-6.0x.
      _________________________________________________________________
 
-   5. I just made tcsh my login shell, and I cannot ftp any more?
+   6. I just made tcsh my login shell, and I cannot ftp any more?
 
    Newer  versions of the ftp daemon check for the validity of the user's
    shell  before  they  allow  logins.  The list of valid login shells is
@@ -81,7 +86,7 @@
    shells for your system, so that other people can ftp too :-)
      _________________________________________________________________
 
-   6.  I  am using SunView? or OpenWindows? and editing is screwed up. In
+   7.  I  am  using  SunView or OpenWindows and editing is screwed up. In
    particular  my  arrow  keys  and backspace don't work right. What am I
    doing wrong?
 
@@ -93,32 +98,36 @@
     1. Don't use suntools
     2. Use shelltool instead of cmdtool.
     3. Unset edit in tcsh.
+     _________________________________________________________________
 
-   6b. On a SPARCstation running Solaris 2.x and OpenWindows? 3.1, inside
-   a  cmdtool,  the  short-cut  key sequence to clear log (i.e. Meta-e or
-   Diamond-e) doesn't work: it just echos 'e' 
+   8. On a SPARCstation running Solaris 2.x and OpenWindows 3.1, inside a
+   cmdtool,  the  short-cut  key  sequence  to  clear log (i.e. Meta-e or
+   Diamond-e) doesn't work: it just echos 'e'; or 
 
-   6c.  On  a  SPARCstation  running  Solaris  2.x  and OpenWindows? 3.1,
-   maketool  (within SPARCworks) doesn't work: it just does a `cd' to the
-   working directory then stops.
+   Unset edit in tcsh.
+     _________________________________________________________________
+
+   9. On a SPARCstation running Solaris 2.x and OpenWindows 3.1, maketool
+   (within  SPARCworks)  doesn't work: it just does a `cd' to the working
+   directory then stops.
 
-   The  workaround  for  6b and 6c is doing "unset edit." Using shelltool
-   instead of cmdtool doesn't fix 6c.
+   Unset  edit  in  tcsh. Using shelltool instead of cmdtool does not fix
+   this.
      _________________________________________________________________
 
-   7.  I rlogin to another machine, and then no matter what I tell 'stty'
+   10. I rlogin to another machine, and then no matter what I tell 'stty'
    I cannot get it to pass 8 bit characters?
 
    Maybe  you  need  to  use  'rlogin  -8'  to  tell rlogin to pass 8 bit
    characters.
      _________________________________________________________________
 
-   8. Where do I get the public domain directory library?
+   11. Where do I get the public domain directory library?
 
    Anonymous ftp to prep.ai.mit.edu:/pub/gnu/dirent.tar.Z
      _________________________________________________________________
 
-   9.  I  compiled  tcsh  using  gcc,  and when I start up it says: tcsh:
+   12.  I  compiled  tcsh  using  gcc, and when I start up it says: tcsh:
    Warning  no  access  to tty (Invalid Argument). Thus no job control in
    this shell
 
@@ -130,13 +139,13 @@
     3. Compile with cc.
      _________________________________________________________________
 
-   10.  I compiled tcsh with the SunOS? unbundled compiler and now things
+   13.  I  compiled tcsh with the SunOS unbundled compiler and now things
    get echo'ed twice.
 
    It is a bug in the unbundled optimizer. Lower the optimization level.
      _________________________________________________________________
 
-   11. How can I use the arrow keys with hpterm?
+   14. How can I use the arrow keys with hpterm?
 
    Hp terminals use the arrow keys internally. You can tell hpterm not to
    do that, by sending it the termcap sequence smkx. Since this has to be
@@ -151,15 +160,15 @@
    if you are using termcap, replace "smkx" with "ks"...
      _________________________________________________________________
 
-   12.  On POSIX machines ^C and ^Z will do not work when tcsh is a login
+   15.  On POSIX machines ^C and ^Z will do not work when tcsh is a login
    shell?
 
    Make sure that the interrupt character is set to ^C and suspend is set
    to  ^Z;  'stty -a' will show you the current stty settings; 'stty intr
    ^C susp ^Z' will set them to ^C and ^Z respectively.
      _________________________________________________________________
 
-   13.  I  am trying to compile tcsh and I am getting compile errors that
+   16.  I  am trying to compile tcsh and I am getting compile errors that
    look like:
 
     >sh.c:???: `STR???' undeclared, outside of functions [gcc]
@@ -169,7 +178,7 @@
    headers. Type 'make clean; make'
      _________________________________________________________________
 
-   14. On the cray, sometimes the CR/LF mapping gets screwed up.
+   17. On the cray, sometimes the CR/LF mapping gets screwed up.
 
    You  are  probably  logged  in  to the cray via telnet. Cray's telnetd
    implements  line  mode  selection the telnet client you are using does
@@ -181,21 +190,21 @@
    character'.
      _________________________________________________________________
 
-   15.  On AU/X, I made tcsh my startup shell, but the mac desktop is not
+   18.  On AU/X, I made tcsh my startup shell, but the mac desktop is not
    starting up (no X11 or Finder), and I only get console emulation.
 
    This is another manifestation of item 5. Just add the pathname to tcsh
    in /etc/shells and everything should work fine.
      _________________________________________________________________
 
-   16.  On  machines  that  use  YP (NIS) tilde expansion might end up in
+   19.  On  machines  that  use  YP (NIS) tilde expansion might end up in
    /dev/null
 
    If  this happens complain to your vendor, to get a new version of NIS.
    You can fix that in tcsh by defining YPBUGS in config.h
      _________________________________________________________________
 
-   17.  Script on SGI 4.0.5 does not give us a tty, so we cannot have job
+   20.  Script on SGI 4.0.5 does not give us a tty, so we cannot have job
    control.
 
    Their csh does not have job control either. Try:
@@ -204,18 +213,21 @@
         % cat > /dev/tty
      _________________________________________________________________
 
-   18. I start tcsh and it takes a couple of minutes to get the prompt.
+   21. I start tcsh and it takes a couple of minutes to get the prompt.
 
    You  have  defined  REMOTEHOST  and your DNS is not responding. Either
    undefine REMOTEHOST and recompile or fix your DNS.
      _________________________________________________________________
 
-   19. If you need help generating your .cshrc file, check out:
+   22. If you need help generating your .cshrc file, check out:
 
-        http://www.imada.ou.dk/~blackie/dotfile/
+        http://www.imada.sdu.dk/~blackie/dotfile/
+
+   or
+        http://www.dotfiles.com
      _________________________________________________________________
 
-   20.  On  POSIX  systems  the  kernel  will send hup signals to all the
+   23.  On  POSIX  systems  the  kernel  will send hup signals to all the
    processes in the foreground process group if 'stty hupcl' is set.
 
    For example
@@ -230,33 +242,63 @@
    avoid that you can set stty -hupcl, but it is not recommended.
      _________________________________________________________________
 
-   21. When I rsh the meta key stops working on the remote machine.
+   24. When I rsh the meta key stops working on the remote machine.
 
    Try  using rsh -8; this option is undocumented on some systems, but it
    works.  If  that does not work, get and use ssh/sshd. You'll be better
    off from a security point of view anyway.
      _________________________________________________________________
 
-   22.  Tcsh  compiled  under  hp/ux-10.x  does  not pass resource limits
+   25.  Tcsh  compiled  under  hp/ux-10.x  does  not pass resource limits
    correctly when ran on hp/ux-11.x systems.
 
    This  is  a  problem  with  lack  of ABI compatibility between the two
    systems. The only solution is to recompile.
      _________________________________________________________________
 
-   23. Refreshing in command line editing can appear broken on some OS's
+   26. Refreshing in command line editing can appear broken on some OS's
 
    This  is  because  the  termcap/terminfo  description  lies  about the
    ability  of  the  terminal  to  use tabs. At least on Compaq/DEC Alpha
    OSF/1 3.x and 4.x systems, stty -tabs will cause problems.
      _________________________________________________________________
 
+   27. Where can I learn the merits of tcsh vs. bash vs. csh vs. sh etc?
+
+   You  can  read  the  manual page section titled [NEW FEATURES] listing
+   features that tcsh adds to csh.
+
+   You  can read Tom Christiansen's [Csh Programming Considered Harmful],
+   a  document advocating that csh (and by extension, tcsh) should not be
+   used for writing shell scripts.
+
+   XXX:  Need  to  find something about [bash], but bash is sh-compatible
+   and  has  many  of  the  same  interactive  features  of tcsh (command
+   completion does not appear to be as flexible, though).
+
+   [Curtains  up:  introducing  the Z shell] has a pretty good rundown on
+   zsh.  Aside  from  the arguments about csh being evil, tcsh appears to
+   compare  well  with zsh [zsh]. Zsh is sh and ksh compatible, with many
+   of the interactive features of tcsh.
+     _________________________________________________________________
+
+   28.  Why  does  FreeBSD's  tcsh do history browsing differently than I
+   expect?
+
+   On    FreeBSD,    by    default,    the    up    arrow   is   set   to
+   "history-search-backward",  rather than the default "up-history". As a
+   result,  if  you  type (part of) a word and press up arrow, you'll see
+   previous  commands  that  match  the  prefix. Pretty useful, actually,
+   although  it  takes  some  getting used to. You can use bindkey to see
+   your settings, and to rebind up & down differently if desired.
+     _________________________________________________________________
+
    Everything else is a bug :-(
 
    Christos
      _________________________________________________________________
 
    Home | RecentChanges | Preferences
    Edit text of this page | View other revisions
-   Last edited April 27, 2001 13:43 (diff)
+   Last edited April 29, 2004 15:02 (diff)
    Search: ____________________

Makefile.ADMIN

@@ -11,6 +11,10 @@ LYNX=	lynx -dump -nolist
 TRIM=	expand | sed -e 's/^  *$$//' | cat -s
 WEB=	http://www.tcsh.org/page?
 
+PAGES=	FAQ WishList
+
+all: ${PAGES}
+
 .for i in FAQ WishList
 $i: force
 	${LYNX} ${WEB}$i | ${TRIM} > ${.TARGET}

RELEASE-PROCEDURE

@@ -12,8 +12,7 @@ HOW TO RELEASE TCSH
     from patchlevel.h (the new values you picked)
 6)  Export the code using the new tag you created.  Rename
     the directory from "tcsh" to "tcsh-x.yy.zz" and create
-    tcsh-x.yy.zz.tar.gz (or tcsh-x.yy.tar.gz for public
-    releases where zz [PATCHLEVEL] is zero)
+    tcsh-x.yy.zz.tar.gz
 7)  Export the previous release as well
 8)  Remove files that should not be in a release:
     - Announce*