Hello,

I believe that a brief description of the behaviour of each shell
configuration file will help new users making changes on the files
themselves.  So, for example, a user will know if a given change
will be available as soon as he/she starts a new shell, or only
when a login shell is started.

Those are the unified diffs for the current files:

[for dot.cshrc]

--- dot.cshrc	Mon Sep 30 12:07:02 2002
+++ dot.cshrc.new	Wed Apr 16 12:24:10 2003
@@ -1,5 +1,11 @@
-#	$NetBSD: dot.cshrc,v 1.2 2002/09/29 14:52:57 grant Exp $
-#csh .cshrc file
+#	$Id$
+#
+# This is the default standard .cshrc provided to csh users.
+# They are expected to edit it to meet their own needs.
+#
+# The commands in this file are executed each time a new csh shell
+# is started.
+#
 
 alias h		history 25
 alias j		jobs -l

[for dot.login]

--- dot.login	Tue Jul  9 12:31:10 2002
+++ dot.login.new	Wed Apr 16 12:24:54 2003
@@ -1,5 +1,11 @@
-#	$NetBSD: dot.login,v 1.2 2002/07/08 02:54:58 grant Exp $
-#csh .login file
+#	$Id$
+#
+# This is the default standard .login provided to csh users.
+# They are expected to edit it to meet their own needs.
+#
+# The commands in this file are executed when a csh user first
+# logs in.  This file is processed after .cshrc.
+#
 
 if ( ! $?SHELL ) then
   setenv SHELL /bin/csh

[for dot.profile]

--- dot.profile	Mon Sep 30 12:07:02 2002
+++ dot.profile.new	Wed Apr 16 12:26:11 2003
@@ -1,4 +1,11 @@
-#	$NetBSD: dot.profile,v 1.2 2002/09/29 14:52:57 grant Exp $
+#	$Id$
+#
+# This is the default standard .profile provided to sh users.
+# They are expected to edit it to meet their own needs.
+#
+# The commands in this file are executed when an sh user first
+# logs in.
+#
 
 PATH=$HOME/bin:/bin:/sbin:/usr/bin:/usr/sbin:/usr/X11R6/bin:/usr/pkg/bin
 PATH=${PATH}:/usr/pkg/sbin:/usr/games:/usr/local/bin:/usr/local/sbin

[a new file, that do not hurts but can be useful to have: dot.logout]

#	$Id$
#
# This is the default standard .logout provided to csh users.
# They are expected to edit it to meet their own needs.
#
# The commands in this file are executed when a login shell
# terminates.
#


This is a common practice on most UNIX operating systems and will
provide a lot of useful information to users.

I am not sure about how managing the keyword strings ($Id$)...
I feel that I should not include them in the patches.

I prefer asking in this mailing list before submitting a PR.

Cheers,
Igor.

-- 
Igor Sobrado, UK34436 - sobrado@acm.org