Date: Fri, 20 Oct 2000 07:26:09 +0200 (CEST) From: Cyrille Lefevre <clefevre@citeweb.net> To: FreeBSD-gnats-submit@freebsd.org Subject: docs/22140: share/doc/*/contents updated for html output w/ unroff Message-ID: <200010200526.e9K5Q9b86599@gits.dyndns.org>
next in thread | raw e-mail | index | archive | help
>Number: 22140
>Category: docs
>Synopsis: share/doc/*/contents updated for html output w/ unroff
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Thu Oct 19 22:30:00 PDT 2000
>Closed-Date:
>Last-Modified:
>Originator: Cyrille Lefevre
>Release: FreeBSD 4.1-STABLE i386
>Organization:
ACME
>Environment:
FreeBSD gits 4.1-STABLE FreeBSD 4.1-STABLE #3: Sat Sep 23 10:20:30 CEST 2000 root@gits:/disk2/4.0-stable/src/sys/compile/CUSTOM i386
>Description:
with this patch, all the contents files found in share/doc
have urls pointing to what they refer when html output is
requested (PRINTERDEVICE=html).
I have tried to use the .Hr macro described in unroff-html(1)
w/o success even when tmac.hyper in included ! so, I use
the .>> macro which works well. if someone find why the
.Hr macro doesn't work, let me know. thanks.
>How-To-Repeat:
lynx share/doc/papers/contents.html and so on.
>Fix:
Index: papers/contents/contents.ms
===================================================================
RCS file: /home/ncvs/src/share/doc/papers/contents/contents.ms,v
retrieving revision 1.4
diff -u -r1.4 contents.ms
--- papers/contents/contents.ms 1999/08/28 00:18:03 1.4
+++ papers/contents/contents.ms 2000/10/20 04:58:13
@@ -36,130 +36,195 @@
.IP
.tl '\fBBerkeley Pascal''px\fP'
+.if \n(.U \{\
+.br
+.>> <a href="px.html">px.html</a>
+.\}
.QP
Berkeley Pascal
PX Implementation Notes
.br
Version 2.0
-
+.sp
Performance Effects of Disk Subsystem Choices
for VAX\(dg Systems Running 4.2BSD UNIX.
-
+.sp
William N. Joy, M. Kirk McKusick.
-
+.sp
Revised January, 1979.
-
+.sp
.IP
.tl '\fBDisk Performance''diskperf\fP'
+.if \n(.U \{\
+.br
+.>> <a href="diskperf.html">diskperf.html</a>
+.\}
.QP
Performance Effects of Disk Subsystem Choices
for VAX\(dg Systems Running 4.2BSD UNIX.
-
+.sp
Bob Kridle, Marshall Kirk McKusick.
-
+.sp
Revised July 27, 1983.
-
+.sp
.IP
.tl '\fBTune the 4.2BSD Kernel''kerntune\fP'
+.if \n(.U \{\
+.br
+.>> <a href="kerntune.html">kerntune.html</a>
+.\}
.QP
Using gprof to Tune the 4.2BSD Kernel.
-
+.sp
Marshall Kirk McKusick.
-
+.sp
Revised May 21, 1984 (?).
-
+.sp
.IP
.tl '\fBNew Virtual Memory''newvm\fP'
+.if \n(.U \{\
+.br
+.>> <a href="newvm.html">newvm.html</a>
+.\}
.QP
A New Virtual Memory Implementation for Berkeley.
-
+.sp
Marshall Kirk McKusick, Michael J. Karels.
-
+.sp
Revised 1986.
-
+.sp
.IP
.tl '\fBKernel Malloc''kernmalloc\fP'
+.if \n(.U \{\
+.br
+.>> <a href="kernmalloc.html">kernmalloc.html</a>
+.\}
.QP
Design of a General Purpose Memory Allocator for the 4.3BSD UNIX Kernel.
-
+.sp
Marshall Kirk McKusick, Michael J. Karels.
-
+.sp
Reprinted from:
\fIProceedings of the San Francisco USENIX Conference\fP,
pp. 295-303, June 1988.
-
+.sp
.IP
.tl '\fBRelease Engineering''relengr\fP'
+.if \n(.U \{\
+.br
+.>> <a href="releng.html">releng.html</a>
+.\}
.QP
The Release Engineering of 4.3\s-1BSD\s0.
-
+.sp
Marshall Kirk McKusick, Michael J. Karels, Keith Bostic.
-
+.sp
Revised 1989.
-
+.sp
.IP
.tl '\fBBeyond 4.3BSD''beyond4.3\fP'
+.if \n(.U \{\
+.br
+.>> <a href="beyond43.html">beyond43.html</a>
+.\}
.QP
Current Research by The Computer Systems Research Group of Berkeley.
-
+.sp
Marshall Kirk McKusick, Michael J Karels, Keith Sklower, Kevin Fall,
Marc Teitelbaum, Keith Bostic.
-
+.sp
Revised February 2, 1989.
-
+.sp
.IP
.tl '\fBMemory Based Filesystem''memfs\fP'
+.if \n(.U \{\
+.br
+.>> <a href="memfs.html">memfs.html</a>
+.\}
.QP
A Pageable Memory Based Filesystem.
-
+.sp
Marshall Kirk McKusick, Michael J. Karels, Keith Bostic.
-
+.sp
Revised 1990.
-
+.sp
.IP
.tl '\fBFilesystem Interface''fsinterface\fP'
+.if \n(.U \{\
+.br
+.>> <a href="fsinterface.html">fsinterface.html</a>
+.\}
.QP
Toward a Compatible Filesystem Interface.
-
+.sp
Michael J. Karels, Marshall Kirk McKusick.
-
+.sp
Conference of the European Users' Group, September 1986.
Last modified April 16, 1991.
-
+.sp
.IP
.tl '\fBSystem Performance''sysperf\fP'
+.if \n(.U \{\
+.br
+.>> <a href="sysperf.html">sysperf.html</a>
+.\}
.QP
Measuring and Improving the Performance of Berkeley UNIX.
-
+.sp
Marshall Kirk McKusick, Samuel J. Leffler, Michael J. Karels.
-
+.sp
Revised April 17, 1991.
-
+.sp
.IP
.tl '\fBNot Quite NFS''nqnfs\fP'
+.if \n(.U \{\
+.br
+.>> <a href="nqnfs.html">nqnfs.html</a>
+.\}
.QP
Not Quite NFS, Soft Cache Consistency for NFS.
-
+.sp
Rick Macklem.
-
+.sp
Reprinted with permission from the "Proceedings of the Winter 1994 Usenix
Conference", January 1994, San Francisco.
+.sp
.IP
.tl '\fBMalloc(3)''malloc\fP'
+.if \n(.U \{\
+.br
+.>> <a href="malloc.html">malloc.html</a>
+.\}
.QP
Malloc(3) in modern Virtual Memory environments.
-
+.sp
Poul-Henning Kamp.
-
+.sp
Revised April 5, 1996.
+
+.sp
+.IP
+.tl '\fBJails: Confining the omnipotent root''jail\fP'
+.if \n(.U \{\
+.br
+.>> <a href="jail.html">jail.html</a>
+.\}
+.QP
+The jail system call sets up a jail and locks the current process in it.
+.sp
+Poul-Henning Kamp, Robert N. M. Watson.
+.sp
+This paper was presented at the 2nd International System Administration
+and Networking Conference "SANE 2000" May 22-25, 2000 in Maastricht,
+The Netherlands and is published in the proceedings.
Index: papers/jail/paper.ms
===================================================================
RCS file: /home/ncvs/src/share/doc/papers/jail/paper.ms,v
retrieving revision 1.4.2.1
diff -u -r1.4.2.1 paper.ms
--- papers/jail/paper.ms 2000/08/20 13:16:44 1.4.2.1
+++ papers/jail/paper.ms 2000/10/20 04:49:00
@@ -11,7 +11,7 @@
.TL
Jails: Confining the omnipotent root.
.FS
-This paper was presented at the 2nd International System Administration and Networking Conference "SANE 2000" May 22-25, 2000 in Maastricht, The Netherlands and is published in the in the proceedings.
+This paper was presented at the 2nd International System Administration and Networking Conference "SANE 2000" May 22-25, 2000 in Maastricht, The Netherlands and is published in the proceedings.
.FE
.AU
Poul-Henning Kamp <phk@FreeBSD.org>
Index: psd/contents/contents.ms
===================================================================
RCS file: /home/ncvs/src/share/doc/psd/contents/contents.ms,v
retrieving revision 1.2
diff -u -r1.2 contents.ms
--- psd/contents/contents.ms 1997/03/04 20:35:32 1.2
+++ psd/contents/contents.ms 2000/10/20 05:07:23
@@ -35,8 +35,12 @@
.EH 'PSD Contents'''
.TL
UNIX Programmer's Supplementary Documents (PSD)
+.if \n(.U \{\
+.br
+.>> <a href="Title.html">Title.html</a>
+.\}
.sp
-\s-24.4 Berkeley Software Distribution\s+2
+\s-2 4.4 Berkeley Software Distribution\s+2
.sp
\fRJune, 1993\fR
.PP
@@ -55,19 +59,19 @@
.QP
Dennis Ritchie and Ken Thompson's original paper about UNIX, reprinted
from Communications of the ACM. (encumbered)
-
+.sp
.IP
.tl 'Unix Implementation''PSD:2'
.QP
Ken Thompson's description of the implementation of the Version 7
kernel and file system. (encumbered)
-
+.sp
.IP
.tl 'The Unix I/O System''PSD:3'
.QP
Dennis Ritchie's overview of the I/O System of Version 7; still helpful for
those writing device drivers. (encumbered)
-
+.sp
.IP
.tl 'Unix Programming \- Second Edition ''PSD:4'
.QP
@@ -76,9 +80,13 @@
Kernighan and Pike, ``The UNIX Programming Environment'',
Prentice-Hall, 1984 and especially by the Programmer Reference Manual
section 2 (system calls) and 3 (library routines). (encumbered)
-
+.sp
.IP
.tl 'Berkeley Software Architecture Manual (4.4 Edition)''PSD:5'
+.if \n(.U \{\
+.br
+.>> <a href="05.sysman/paper.html">05.sysman/paper.html</a>
+.\}
.QP
A concise and terse description of the system call interface
provided in Berkeley Unix, as revised for 4.4BSD.
@@ -93,20 +101,20 @@
Should be supplemented by ``The C Programming Language,''
B.W. Kernighan and D.M. Ritchie, Prentice-Hall, 1978, that
contains a tutorial introduction and many examples. (encumbered)
-
+.sp
.IP
.tl 'Berkeley Pascal User\'s Manual''PSD:7'
.QP
An implementation of this language popular for learning to program.
(Not provided in FreeBSD.)
-
+.sp
.IP
.tl 'A Portable Fortran 77 Compiler''PSD:8'
.QP
A revised version of the document which originally appeared in
Volume 2b of the Bell Labs documentation;
this version reflects the work done at Berkeley. (encumbered)
-
+.sp
.IP
.tl 'Introduction to the f77 I/O Library''PSD:9'
.QP
@@ -121,53 +129,65 @@
How to debug programs using the source level \fIgdb\fP debugger
(or how to debug programs without having to know much about machine language).
(A TeXinfo version is provided separately.)
-
+.sp
.IP
.tl 'A Tutorial Introduction to ADB''PSD:11'
.QP
How to debug programs using the assembly-language level \fIadb\fP debugger.
(encumbered)
-
+.sp
.IP
.tl 'Make \- A Program for Maintaining Computer Programs''PSD:12'
+.if \n(.U \{\
+.br
+.>> <a href="12.make/paper.html">12.make/paper.html</a>
+.\}
.QP
Indispensable tool for making sure large programs are properly
compiled with minimal effort.
-
+.sp
.IP
.tl 'An Introduction to the Revision Control System''PSD:13'
+.if \n(.U \{\
+.br
+.>> <a href="13.rcs/paper.html">13.rcs/paper.html</a>
+.\}
.QP
RCS is a user-contributed tool for working together with other people
without stepping on each other's toes.
An alternative to \fIsccs\fR for controlling software changes.
-
+.sp
.IP
.tl 'An Introduction to the Source Code Control System''PSD:14'
.QP
A useful introductory article for those users with
installations licensed for SCCS. (encumbered)
-
+.sp
.IP
.tl 'YACC: Yet Another Compiler-Compiler''PSD:15'
.QP
Converts a BNF specification of a language and semantic actions
written in C into a compiler for that language. (encumbered)
-
+.sp
.IP
.tl 'LEX \- A Lexical Analyzer Generator''PSD:16'
.QP
Creates a recognizer for a set of regular expressions:
each regular expression can be followed by arbitrary C code
to be executed upon finding the regular expression. (encumbered)
-
+.sp
.IP
.tl 'The M4 Macro Processor''PSD:17'
.QP
M4 is a macro processor useful in its own right and as a
front-end for C, Ratfor, and Cobol.
-
+.sp
.IP
.tl 'gprof: a Call Graph Execution Profiler''PSD:18'
+.if \n(.U \{\
+.br
+.>> <a href="18.gprof/paper.html">18.gprof/paper.html
+.\}
.QP
A program to show the call graph and execution time of a program.
Indispensable aid for improving the running time of almost everything.
@@ -184,53 +204,89 @@
General Reference
.IP
.tl 'An Introductory 4.4BSD Interprocess Communication Tutorial''PSD:20'
+.if \n(.U \{\
+.br
+.>> <a href="20.ipctut/paper.html">20.ipctut/paper.html
+.\}
.QP
How to write programs that use the Interprocess Communication Facilities
of 4.4BSD.
-
+.sp
.IP
.tl 'An Advanced 4.4BSD Interprocess Communication Tutorial''PSD:21'
+.if \n(.U \{\
+.br
+.>> <a href="21.ipc/paper.html">21.ipc/paper.html
+.\}
.QP
The reference document (with some examples) for the Interprocess Communication
Facilities of 4.4BSD.
-
+.sp
.IP
.tl 'RPCGEN Programming Guide''PSD:22'
+.if \n(.U \{\
+.br
+.>> <a href="22.rpcgen/paper.html">22.rpcgen/paper.html
+.\}
.QP
Manual for the ONC RPC stub-generating program, provided by Sun Microsystems.
-
+.sp
.IP
.tl 'Remote Procedure Call Programming Guide''PSD:23'
+.if \n(.U \{\
+.br
+.>> <a href="23.rpc/paper.html">23.rpc/paper.html
+.\}
.QP
A tutorial introduction to programming the ONC RPC system, provided by
Sun Microsystems.
-
+.sp
.IP
.tl 'External Data Representation: Sun Technical Notes''PSD:24'
+.if \n(.U \{\
+.br
+.>> <a href="24.xdr/paper.html">24.xdr/paper.html
+.\}
.QP
Technical details about the design of the XDR component of ONC RPC,
provided by Sun Microsystems.
-
+.sp
.IP
.tl 'External Data Representation Standard: Protocol Specification''PSD:25'
+.if \n(.U \{\
+.br
+.>> <a href="25.xdrrfc/paper.html">25.xdrrfc/paper.html
+.\}
.QP
The Internet RFC specifying ONC XDR, provided by Sun Microsystems.
-
+.sp
.IP
.tl 'Remote Procedure Calls: Protocol Specification''PSD:26'
+.if \n(.U \{\
+.br
+.>> <a href="26.rpcrfc/paper.html">26.rpcrfc/paper.html
+.\}
.QP
The Internet RFC specifying ONC RPC, RFC 1050, as provided by Sun
Microsystems.
-
+.sp
.IP
.tl 'Network File System: Version 2 Protocol Specification''PSD:27'
+.if \n(.U \{\
+.br
+.>> <a href="27.nfsrpc/paper.html">27.nfsrpc/paper.html
+.\}
.QP
The Internet RFC specifying NFS, as provided by Sun Microsystems.
Note that the NFS-compatible filesystem itself, while
compliant with this specification, was not provided by Sun.
-
+.sp
.IP
.tl 'CVS II: Parallelizing Software Development''PSD:28'
+.if \n(.U \{\
+.br
+.>> <a href="28.cvs/paper.html">28.cvs/paper.html
+.\}
.QP
CVS (Concurrent Versions System) is a front end to the
RCS revision control system which extends the notion of
Index: smm/contents/contents.ms
===================================================================
RCS file: /home/ncvs/src/share/doc/smm/contents/contents.ms,v
retrieving revision 1.1.10.1
diff -u -r1.1.10.1 contents.ms
--- smm/contents/contents.ms 2000/08/27 17:31:41 1.1.10.1
+++ smm/contents/contents.ms 2000/10/20 05:06:45
@@ -36,8 +36,12 @@
.EH 'SMM Contents'''
.TL
UNIX System Manager's Manual (SMM)
+.if \n(.U \{\
+.br
+.>> <a href="Title.html">Title.html</a>
+.\}
.sp
-\s-24.4 Berkeley Software Distribution\s+2
+\s-2 4.4 Berkeley Software Distribution\s+2
.sp
\fRJune, 1993\fR
.PP
@@ -55,36 +59,60 @@
System Installation and Administration
.IP
.tl 'Installing and Operating 4.4BSD''SMM:1'
+.if \n(.U \{\
+.br
+.>> <a href="01.setup/paper.html">01.setup/paper.html</a>
+.\}
.QP
The definitive reference document for those occasions when
you find you need to start over again.
.IP
.tl 'Building 4.4BSD Kernels with \fIConfig\fP''SMM:2'
+.if \n(.U \{\
+.br
+.>> <a href="02.config/paper.html">02.config/paper.html</a>
+.\}
.QP
In-depth discussions of the use and operation of the \fIconfig\fP
program, and how to build your very own Unix kernel.
.IP
.tl 'Fsck \- The UNIX File System Check Program''SMM:3'
+.if \n(.U \{\
+.br
+.>> <a href="03.fsck/paper.html">03.fsck/paper.html</a>
+.\}
.QP
A reference document for using the \fIfsck\fP program during
times of file system distress.
.IP
.tl 'Disc Quotas in a UNIX Environment''SMM:4'
+.if \n(.U \{\
+.br
+.>> <a href="04.quotas/paper.html">04.quotas/paper.html</a>
+.\}
.QP
A light introduction to the techniques
for limiting the use of disc resources.
.IP
.tl 'A Fast File System for UNIX''SMM:5'
+.if \n(.U \{\
+.br
+.>> <a href="05.fastfs/paper.html">05.fastfs/paper.html</a>
+.\}
.QP
A description of the 4.4BSD file system organization,
design and implementation.
.IP
.tl 'The 4.4BSD NFS Implementation''SMM:6'
+.if \n(.U \{\
+.br
+.>> <a href="06.nfs/paper.html">06.nfs/paper.html</a>
+.\}
.QP
An overview of the design, implementation, and use of NFS on 4.4BSD.
@@ -96,24 +124,40 @@
.IP
.tl 'Sendmail Installation and Operation Guide''SMM:8'
+.if \n(.U \{\
+.br
+.>> <a href="08.sendmailop/paper.html">08.sendmailop/paper.html</a>
+.\}
.QP
The last word in installing and operating the \fIsendmail\fP program.
.ne 3
.IP
.tl 'Name Server Operations Guide for BIND''SMM:10'
+.if \n(.U \{\
+.br
+.>> <a href="10.named/paper.html">10.named/paper.html</a>
+.\}
.QP
Setting up and operating the name to Internet addressing software.
If you have a network this will be of interest.
.IP
.tl 'Timed Installation and Operation Guide''SMM:11'
+.if \n(.U \{\
+.br
+.>> <a href="11.timedop/paper.html">11.timedop/paper.html</a>
+.\}
.QP
Describes how to maintain time synchronization between machines
in a local network.
.IP
.tl 'The Berkeley UNIX Time Synchronization Protocol''SMM:12'
+.if \n(.U \{\
+.br
+.>> <a href="12.timed/paper.html">12.timed/paper.html</a>
+.\}
.QP
The protocols and algorithms used by timed,
the network time synchronization daemon.
@@ -146,6 +190,10 @@
.IP
.tl 'Networking Implementation Notes, 4.4BSD Edition''SMM:18'
+.if \n(.U \{\
+.br
+.>> <a href="18.net/paper.html">18.net/paper.html</a>
+.\}
.QP
A concise description of the system interfaces used within the
networking subsystem.
Index: usd/contents/contents.ms
===================================================================
RCS file: /home/ncvs/src/share/doc/usd/contents/contents.ms,v
retrieving revision 1.1
diff -u -r1.1 contents.ms
--- usd/contents/contents.ms 1995/01/11 03:24:26 1.1
+++ usd/contents/contents.ms 2000/10/20 05:08:06
@@ -40,8 +40,12 @@
.EH 'USD Contents'''
.TL
UNIX User's Supplementary Documents (USD)
+.if \n(.U \{\
+.br
+.>> <a href="Title.html">Title.html</a>
+.\}
.sp
-\s-24.4 Berkeley Software Distribution\s+2
+\s-2 4.4 Berkeley Software Distribution\s+2
.sp
\fRJune, 1993\fR
.PP
@@ -78,6 +82,10 @@
.ND
.IP
.tl 'An Introduction to the C shell''USD:4'
+.if \n(.U \{\
+.br
+.>> <a href="04.csh/paper.html">04.csh/paper.html</a>
+.\}
.QP
This introduction to
.I csh,
@@ -101,6 +109,10 @@
.ND
.IP
.tl 'Mail Reference Manual''USD:7'
+.if \n(.U \{\
+.br
+.>> <a href="07.mail/paper.html">07.mail/paper.html</a>
+.\}
.QP
Complete details on one of the programs for sending and reading your mail.
.ND
@@ -121,21 +133,37 @@
.ND
.IP
.tl 'Advanced Editing on Unix''USD:10'
+.if \n(.U \{\
+.br
+.>> <a href="10.exref/paper.html">10.exref/paper.html</a>
+.\}
.QP
The next step.
.ND
.IP
.tl 'An Introduction to Display Editing with Vi''USD:11'
+.if \n(.U \{\
+.br
+.>> <a href="11.vitut/paper.html">11.vitut/paper.html</a>
+.\}
.QP
The document to learn to use the \fIvi\fR screen editor.
.ND
.IP
.tl 'Ex Reference Manual (Version 3.7)''USD:12'
+.if \n(.U \{\
+.br
+.>> <a href="12.vi/paper.html">12.vi/paper.html</a>
+.\}
.QP
The final reference for the \fIex\fR editor.
.ND
.IP
.tl 'Vi Reference Manual''USD:13'
+.if \n(.U \{\
+.br
+.>> <a href="13.viref/paper.html">13.viref/paper.html</a>
+.\}
.QP
The definitive reference for the \fInvi\fR editor.
.ND
@@ -170,18 +198,30 @@
.ND
.IP
.tl 'A Revised Version of \-ms''USD:18'
+.if \n(.U \{\
+.br
+.>> <a href="18.msdiffs/paper.html">18.msdiffs/paper.html</a>
+.\}
.QP
A brief description of the Berkeley revisions made to the \-ms formatting
macros for nroff and troff.
.ND
.IP
.tl 'Writing Papers with \fInroff\fR using \-me''USD:19'
+.if \n(.U \{\
+.br
+.>> <a href="19.memacros/paper.html">19.memacros/paper.html</a>
+.\}
.QP
Another popular macro package for
.I nroff.
.ND
.IP
.tl '\-me Reference Manual''USD:20'
+.if \n(.U \{\
+.br
+.>> <a href="20.meref/paper.html">20.meref/paper.html</a>
+.\}
.QP
The final word on \-me.
.ND
@@ -250,12 +290,20 @@
.ND
.IP
.tl 'A Guide to the Dungeons of Doom''USD:30'
+.if \n(.U \{\
+.br
+.>> <a href="30.rogue/paper.html">30.rogue/paper.html</a>
+.\}
.QP
An introduction to the popular game of \fIrogue\fP, a fantasy game
which is one of the biggest known users of VAX cycles.
.ND
.IP
.tl 'Star Trek''USD:31'
+.if \n(.U \{\
+.br
+.>> <a href="31.trek/paper.html">31.trek/paper.html</a>
+.\}
.QP
You are the Captain of the Starship Enterprise. Wipe out the
Klingons and save the Federation.
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200010200526.e9K5Q9b86599>