[PATCH app-sessreg 2/4] man: SEE ALSO: computing the man pages to reference is not required

Gaetan Nadon memsize at videotron.ca
Mon Mar 14 11:19:47 PDT 2011


The man page explains the different implementations of utmp
and extended utmp. The information is not limited to the platform
where the man page is being built, as it should.

However, when it comes to list man pages of possible interest,
either utmp(5) or utmpx(5) is selected, but not both.
This is not consistent with the documentation strategy and is wrong
on some platforms. The computation is based on the headers found
during build.

On MAC, both utmp.h and utmpx.h are present, but utmp.h is deprecated.
When updates are done in utmpx, they are also reflected in utmp for
backward compatibility. It is useful to have references to both
utmp and utmpx. NetBSD has both utmp and utmpx as well.

If you access the man pages for MAC or NetBSD, you will see those
utmp and utmpx anyway.

There are too many variations in the implementation which cannot be reflected
in the man page text or in the the seessreg command options.
Why would the referenced man page be "utmpx" only when the -u option
mentions "utmp-file".

Signed-off-by: Gaetan Nadon <memsize at videotron.ca>
---
 man/filenames.sed.c |    3 ---
 man/sessreg.man     |    3 ++-
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/man/filenames.sed.c b/man/filenames.sed.c
index 667552d..17b01d7 100644
--- a/man/filenames.sed.c
+++ b/man/filenames.sed.c
@@ -2,10 +2,8 @@
 
 #ifdef UTMPX_FILE
 # define UTF UTMPX_FILE
-# define UTM utmpx
 #else
 # define UTF UTMP_FILE
-# define UTM utmp
 #endif
 
 #ifdef WTMPX_FILE
@@ -18,7 +16,6 @@
 # define LLOG_FILE "/var/log/lastlog"
 #endif
 
-s|__utmp_manpage__|UTM|g
 s|__utmp_file__|UTF|g
 s|__wtmp_file__|WTF|g
 s|__lastlog_file__|LLOG_FILE|g
diff --git a/man/sessreg.man b/man/sessreg.man
index cf86774..c1a0dfe 100644
--- a/man/sessreg.man
+++ b/man/sessreg.man
@@ -130,6 +130,7 @@ This session should be deleted from utmp/wtmp.  One of -a/-d must
 be specified.
 .SH "SEE ALSO"
 .BR xdm (__appmansuffix__),
-.BR __utmp_manpage__ (__filemansuffix__)
+.BR utmp (__filemansuffix__),
+.BR utmpx (__filemansuffix__)
 .SH AUTHOR
 Keith Packard, MIT X Consortium
-- 
1.6.0.4



More information about the xorg-devel mailing list