Hi,
Here are a (small) handful of examples added using the help2man
method having added it to the source of each of five of the
programs.
Dave
-----Open up your eyes, open up your mind, open up your code -------
/ Dr. David Alan Gilbert | Running GNU/Linux on Alpha,68K| Happy \
\ gro.gilbert @ treblig.org | MIPS,x86,ARM,SPARC,PPC & HPPA | In Hex /
\ _________________________|_____ http://www.treblig.org |_______/
Index: src/chmod.c
===================================================================
RCS file: /cvsroot/coreutils/coreutils/src/chmod.c,v
retrieving revision 1.108
diff -u -r1.108 chmod.c
--- src/chmod.c 28 Mar 2005 17:46:55 -0000 1.108
+++ src/chmod.c 24 Apr 2005 19:08:06 -0000
@@ -327,6 +327,16 @@
Each MODE is one or more of the letters ugoa, one of the symbols +-= and\n\
one or more of the letters rwxXstugo.\n\
"), stdout);
+ printf (_("\
+\n\
+Examples:\n\
+ %s +x afile Make 'afile' executable.\n\
+ %s g+r afile Make 'afile' readable by members of its group.\n\
+ %s o-r afile Remove read access for everyone outside the group.\n\
+ %s 600 afile Make 'afile' readable and writeable by the owner only.\n\
+ %s -R a+w adir Directory 'adir' & all children made writeable by all.\n\
+"),
+ program_name, program_name, program_name, program_name, program_name);
printf (_("\nReport bugs to <%s>.\n"), PACKAGE_BUGREPORT);
}
exit (status);
Index: src/chroot.c
===================================================================
RCS file: /cvsroot/coreutils/coreutils/src/chroot.c,v
retrieving revision 1.48
diff -u -r1.48 chroot.c
--- src/chroot.c 17 Nov 2004 00:56:25 -0000 1.48
+++ src/chroot.c 24 Apr 2005 19:08:06 -0000
@@ -57,6 +57,14 @@
\n\
If no command is given, run ``${SHELL} -i'' (default: /bin/sh).\n\
"), stdout);
+ printf (_("\
+\n\
+Examples:\n\
+ %s /mnt/new Start a new shell with '/mnt/new' as its root.\n\
+ %s /mnt/new bin/prog Run 'bin/prog' with '/mnt/new' as its root.\n\
+"),
+ program_name, program_name);
+
printf (_("\nReport bugs to <%s>.\n"), PACKAGE_BUGREPORT);
}
exit (status);
Index: src/cksum.c
===================================================================
RCS file: /cvsroot/coreutils/coreutils/src/cksum.c,v
retrieving revision 1.74
diff -u -r1.74 cksum.c
--- src/cksum.c 6 Mar 2005 16:30:57 -0000 1.74
+++ src/cksum.c 24 Apr 2005 19:08:06 -0000
@@ -277,6 +277,14 @@
"), stdout);
fputs (HELP_OPTION_DESCRIPTION, stdout);
fputs (VERSION_OPTION_DESCRIPTION, stdout);
+ printf (_("\
+\n\
+Examples:\n\
+ %s afile Print CRC checksum and byte count for 'afile'.\n\
+ %s afile bfile Print separate checksums and byte counts for each file.\n\
+"),
+ program_name, program_name);
+
printf (_("\nReport bugs to <%s>.\n"), PACKAGE_BUGREPORT);
}
exit (status);
Index: src/comm.c
===================================================================
RCS file: /cvsroot/coreutils/coreutils/src/comm.c,v
retrieving revision 1.81
diff -u -r1.81 comm.c
--- src/comm.c 12 Apr 2005 06:46:10 -0000 1.81
+++ src/comm.c 24 Apr 2005 19:08:06 -0000
@@ -92,6 +92,14 @@
"), stdout);
fputs (HELP_OPTION_DESCRIPTION, stdout);
fputs (VERSION_OPTION_DESCRIPTION, stdout);
+ printf (_("\
+\n\
+Examples:\n\
+ %s file1 file2 Compare presorted files; display unique and common
lines.\n\
+ %s -1 -2 f1 f2 List lines common to both files.\n\
+ %s -3 f1 f2 List lines unique to either file.\n\
+"),
+ program_name, program_name, program_name);
printf (_("\nReport bugs to <%s>.\n"), PACKAGE_BUGREPORT);
}
exit (status);
Index: src/cp.c
===================================================================
RCS file: /cvsroot/coreutils/coreutils/src/cp.c,v
retrieving revision 1.206
diff -u -r1.206 cp.c
--- src/cp.c 28 Mar 2005 17:49:12 -0000 1.206
+++ src/cp.c 24 Apr 2005 19:08:06 -0000
@@ -253,6 +253,16 @@
options are given and SOURCE and DEST are the same name for an existing,\n\
regular file.\n\
"), stdout);
+ printf (_("\
+\n\
+Examples:\n\
+ %s a n Make a copy of 'a' with the name 'n'.\n\
+ %s a d Copy 'a' as a new file 'a' in the existing directory 'd'.\n\
+ %s -a d1 d2 Copy directory 'd1' and its children into 'd2/d1'.\n\
+ %s -ax d1 d2 As above but make sure to stay in the same filesystem.\n\
+"),
+ program_name, program_name, program_name, program_name);
+
printf (_("\nReport bugs to <%s>.\n"), PACKAGE_BUGREPORT);
}
exit (status);
Index: ChangeLog
===================================================================
RCS file: /cvsroot/coreutils/coreutils/ChangeLog,v
retrieving revision 1.1281
diff -u -r1.1281 ChangeLog
--- ChangeLog 23 Apr 2005 05:41:16 -0000 1.1281
+++ ChangeLog 24 Apr 2005 19:08:17 -0000
@@ -1,3 +1,7 @@
+2005-04-24 Dave Gilbert <[EMAIL PROTECTED]>
+
+ * chmod.c, chroot.c, cksum.c, comm.c, cp.c: Add examples
+
2005-04-22 Paul Eggert <[EMAIL PROTECTED]>
* Version 5.3.1.
_______________________________________________
Bug-coreutils mailing list
[email protected]
http://lists.gnu.org/mailman/listinfo/bug-coreutils
