148 Commits

Author SHA1 Message Date
ben
bef994a037 Mention mergemaster(8).
Submitted by:	obrien
2000-11-24 10:22:08 +00:00
ben
fd757c350a Use a more generic name for the compiler cross-reference. (cc instead of
gcc.)

Suggested by:	sheldonh (not sholdonh)
2000-11-23 14:44:45 +00:00
ben
0a9dfbad34 * Say that ps, top, etc, "may not work" with the new kernel, rather than
"will not work", as in many cases they will.

Suggested by:	sholdonh

* Add cross-references to reboot(8) and shutdown(8)
2000-11-23 14:19:50 +00:00
ben
572fa4367d Add an example to explain the basic procedure to build the world.
Suggested by:	obrien
2000-11-23 14:00:26 +00:00
ben
7ef3fd6667 Add two new manual pages to document the various options available in
make.conf, and the /usr/src building process.

PR:		22676
Submitted by:	Mike Meyer <mwm@mired.org>
Reviewed by:	nik, sheldonh
2000-11-22 14:04:26 +00:00
ru
835a46c9c2 mdoc(7) police: do not split author names in the AUTHORS section. 2000-11-22 09:35:58 +00:00
ru
2a74c26618 Make An macro understand two special arguments, -nosplit
and -split.  See the mdoc.samples(7) manpage for details.

Reviewed by:	sheldonh
2000-11-22 08:39:17 +00:00
ru
e53fe708bf mdoc(7) police: fixed the section reference to the mdoc.samples(7). 2000-11-21 08:12:23 +00:00
ru
0100fd6e93 mdoc(7) police: use the new features of the Nm macro. 2000-11-20 18:41:33 +00:00
sheldonh
7dce6cfb76 Document the libcompat entry for the .Lb macro.
Submitted by:	phantom
2000-11-20 16:14:08 +00:00
ru
7d99729431 Use Fx macro wherever possible. 2000-11-14 11:20:58 +00:00
mpp
f60035bbbd Do not terminate the SEE ALSO section example with a period.
The cross-reference list should not be terminated with any
type of punctuation at the end of the line.

Pointed-out-by: sheldonh
2000-11-13 15:54:47 +00:00
ru
a6f5d950d8 Avoid use of direct troff requests in mdoc(7) manual pages. 2000-11-10 17:46:15 +00:00
joe
0efe0bb3cb Scripts should contain a comment block describing what the script does. 2000-10-19 18:18:35 +00:00
joe
e1d76cbbc6 Reference Larry Wall's perlstyle man page, and recommend it's use where
entries in this guide don't override it.

Requested by:	markm

Comment on tabulation style.
2000-10-18 21:57:37 +00:00
joe
784dd58645 Use 'unless' instead of 'if (! ... )' where it improves readability. 2000-10-18 18:01:35 +00:00
joe
e8f6f29b2c Opening braces should be at the end of the controlling line. Else
and elsif belong on the same line as the closing brace for the
previous if or elsif block.

Suggested by:	des
2000-10-18 17:48:10 +00:00
joe
3b94882f32 Contract a statement that's too verbose. 2000-10-18 17:34:43 +00:00
joe
c3bcc6f189 There are enough examples of using 'my $var = ...' definitions, so remove
one.
2000-10-18 17:32:21 +00:00
joe
aa9061a17f All variables should be commented.
Local variables should be separated from function arguments by a
blank line.

Suggested by:	des
2000-10-18 17:25:59 +00:00
joe
d1eac60c8c Make subroutine prototypes mandatory.
The main code should be wrapped in a MAIN:{ ... } declaration.

Suggested by:	des
2000-10-18 17:21:54 +00:00
joe
440545207b Fix the places that I missed last commit: 'vars' not 'var'. 2000-10-18 17:12:07 +00:00
joe
64c0465316 Correction: 'use vars ..' not 'use var'.
Submitted by:	des
2000-10-17 15:50:22 +00:00
joe
b918a3ad6c Build and install the perl.style(7) manual page. 2000-10-17 15:33:29 +00:00
joe
5798bc3fbd Reclarify variable definition blocks.
Ask programmers to use modules where possible instead of reinventing
  the wheel.
Use 'chomp' not 'chop' please.
Fixup some mdoc.
2000-10-17 15:32:57 +00:00
joe
07afce21e9 An initial draft of a style guide for perl scripts in the tree. 2000-10-17 02:51:03 +00:00
obrien
dfd00c165f Add `isoC-99' to the list of availble abbreviations. 2000-10-11 19:30:41 +00:00
murray
722bd18481 Fix typo : s/maintaince/maintenance/ 2000-10-03 07:38:41 +00:00
phantom
4b6d1d09be Document 'libusb' option for .Lb macro 2000-09-22 14:36:06 +00:00
obrien
93fc8a1033 The kernel is now known as `kernel.ko' and it and its matching modules
live in ``/boot/kernel/''.
2000-09-06 17:51:31 +00:00
green
2a6373ea61 Capitalize the last two entries. Note that i8254 is a timer. Report
that TSC is for any fifth-gneration of later x86 processor, not an
i586, and document that it _is_ available to applications.
2000-07-28 21:48:58 +00:00
mpp
bd6ff3da97 Remove some mis-leading text from the "Libraries" section. 2000-06-24 23:02:01 +00:00
ru
7e5624f6ce Document /usr/lib/aout.
PR:		conf/18167
2000-06-07 07:41:09 +00:00
ru
96199a91ad /usr/mdec has gone 1.5 years ago. 2000-06-05 16:14:51 +00:00
sheldonh
14e9cd73ea Fix miscellaneous mdoc macro argument limit infringements.
PR:		18465
Reported by:	Kazu TAKAMUNE <takamune@avrl.mei.co.jp>
2000-05-09 14:02:06 +00:00
phantom
c7b17c64fe Add libipsec to the list of available libraries 2000-05-04 17:58:22 +00:00
phantom
cbeef441ea Document .Fx', .Nx' and `.Ox' macros as callable and parsable. 2000-05-04 16:25:27 +00:00
phantom
f585d93a0a Add expanded information about .Lb macro 2000-04-23 14:50:38 +00:00
phantom
40d2f93ad8 Add information about newly added .Lb macro 2000-04-23 14:49:22 +00:00
nik
e42546b987 Note that openssh/ssl are in the tree now, and use the correct section
numbers for accton(8), sshd(8), and syslogd(8).

PR:             docs/17100
Submitted by:   Udo Erdelhoff <ue@nathan.ruhr.de>
2000-03-07 13:59:26 +00:00
sheldonh
88dd9b4faa Remove single-space hard sentence breaks. These degrade the quality
of the typeset output, tend to make diffs harder to read and provide
bad examples for new-comers to mdoc.
2000-03-03 14:05:08 +00:00
kris
e5a07357d7 Document OpenSSL directories. 2000-01-30 04:22:11 +00:00
chris
d19047f468 Update the /usr/include/ hierarchy for the cam/ and cam/scsi/ directories.
PR:		16345
Submitted by:	Nick Hibma (henny) <n_hibma@webweaving.org>
2000-01-29 06:42:23 +00:00
n_hibma
7d24a31cec Install the USB include files in /usr/include/dev/usb.
We should still sort out some way of avoiding the clutter. Not all files
should be there.

Prompted by:   Louis A. Mamakos <louie@TransSys.COM>
2000-01-25 09:24:23 +00:00
phantom
f370c55053 Fix typos.
PR:		docs/15781
Submitted by:	Christian Weisgerber <naddy@mips.rhein-neckar.de>
2000-01-07 13:20:55 +00:00
itojun
b5c109c129 bring in description for KAME IPv6 changes.
XXX it looks that sysctl.3 lacks most of PF_INET items.
Reviewed by:	shin
Obtained from:	KAME (netbsd-current)
2000-01-06 03:47:57 +00:00
hoek
382369f3fd .Xr pkg_version 1 2000-01-02 17:55:03 +00:00
asmodai
216d01507f Fix some typo's.
PR:		15678
Submitted by:	Christian Weisgerber <naddy@mips.rhein-neckar.de>
1999-12-27 11:02:43 +00:00
dcs
ef74d85fe0 Add /boot. 1999-12-08 22:03:44 +00:00
mpp
8c96c247df Update mdoc(7) and mdoc.samples(7) to list the preferred order
of manual page sections.  Make the two man pages consistent
with each other in the headers they list and they order they list
them in.

Note:  this is the preferred ordering.  All new man pages/additions
to man pages should try and follow this.  Existing man pages
should be left alone, unless you are making major changes  in
the man page and re-ordering of the sections is only a
minor part of the change.

PR:		doc/15352, doc/15353
1999-12-08 21:50:11 +00:00