From owner-freebsd-doc Thu Oct 19 22:30:20 2000 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 180D337B4D7 for ; Thu, 19 Oct 2000 22:30:01 -0700 (PDT) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id WAA94589; Thu, 19 Oct 2000 22:30:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from lafontaine.cybercable.fr (lafontaine.cybercable.fr [212.198.0.202]) by hub.freebsd.org (Postfix) with SMTP id B0C0237B479 for ; Thu, 19 Oct 2000 22:26:13 -0700 (PDT) Received: (qmail 190892 invoked from network); 20 Oct 2000 05:26:10 -0000 Received: from r227m167.cybercable.tm.fr (HELO gits.dyndns.org) ([195.132.227.167]) (envelope-sender ) by lafontaine.cybercable.fr (qmail-ldap-1.03) with SMTP for ; 20 Oct 2000 05:26:10 -0000 Received: (from root@localhost) by gits.dyndns.org (8.11.0/8.11.0) id e9K5Q9b86599; Fri, 20 Oct 2000 07:26:09 +0200 (CEST) (envelope-from root) Message-Id: <200010200526.e9K5Q9b86599@gits.dyndns.org> Date: Fri, 20 Oct 2000 07:26:09 +0200 (CEST) From: Cyrille Lefevre Reply-To: clefevre@citeweb.net To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/22140: share/doc/*/contents updated for html output w/ unroff Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >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 +.>> px.html +.\} .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 +.>> diskperf.html +.\} .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 +.>> kerntune.html +.\} .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 +.>> newvm.html +.\} .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 +.>> kernmalloc.html +.\} .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 +.>> releng.html +.\} .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 +.>> beyond43.html +.\} .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 +.>> memfs.html +.\} .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 +.>> fsinterface.html +.\} .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 +.>> sysperf.html +.\} .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 +.>> nqnfs.html +.\} .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 +.>> malloc.html +.\} .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 +.>> jail.html +.\} +.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 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 +.>> Title.html +.\} .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 +.>> 05.sysman/paper.html +.\} .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 +.>> 12.make/paper.html +.\} .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 +.>> 13.rcs/paper.html +.\} .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 +.>> 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 +.>> 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 +.>> 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 +.>> 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 +.>> 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 +.>> 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 +.>> 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 +.>> 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 +.>> 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 +.>> 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 +.>> Title.html +.\} .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 +.>> 01.setup/paper.html +.\} .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 +.>> 02.config/paper.html +.\} .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 +.>> 03.fsck/paper.html +.\} .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 +.>> 04.quotas/paper.html +.\} .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 +.>> 05.fastfs/paper.html +.\} .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 +.>> 06.nfs/paper.html +.\} .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 +.>> 08.sendmailop/paper.html +.\} .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 +.>> 10.named/paper.html +.\} .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 +.>> 11.timedop/paper.html +.\} .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 +.>> 12.timed/paper.html +.\} .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 +.>> 18.net/paper.html +.\} .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 +.>> Title.html +.\} .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 +.>> 04.csh/paper.html +.\} .QP This introduction to .I csh, @@ -101,6 +109,10 @@ .ND .IP .tl 'Mail Reference Manual''USD:7' +.if \n(.U \{\ +.br +.>> 07.mail/paper.html +.\} .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 +.>> 10.exref/paper.html +.\} .QP The next step. .ND .IP .tl 'An Introduction to Display Editing with Vi''USD:11' +.if \n(.U \{\ +.br +.>> 11.vitut/paper.html +.\} .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 +.>> 12.vi/paper.html +.\} .QP The final reference for the \fIex\fR editor. .ND .IP .tl 'Vi Reference Manual''USD:13' +.if \n(.U \{\ +.br +.>> 13.viref/paper.html +.\} .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 +.>> 18.msdiffs/paper.html +.\} .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 +.>> 19.memacros/paper.html +.\} .QP Another popular macro package for .I nroff. .ND .IP .tl '\-me Reference Manual''USD:20' +.if \n(.U \{\ +.br +.>> 20.meref/paper.html +.\} .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 +.>> 30.rogue/paper.html +.\} .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 +.>> 31.trek/paper.html +.\} .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