Josef Karthauser
c5bb0e9394
Scripts should contain a comment block describing what the script does.
2000-10-19 18:18:35 +00:00
Josef Karthauser
22bbcf38a7
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
Josef Karthauser
e6e692447c
Use 'unless' instead of 'if (! ... )' where it improves readability.
2000-10-18 18:01:35 +00:00
Josef Karthauser
32d219825c
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
Josef Karthauser
a2a307a14d
Contract a statement that's too verbose.
2000-10-18 17:34:43 +00:00
Josef Karthauser
a669270dee
There are enough examples of using 'my $var = ...' definitions, so remove
...
one.
2000-10-18 17:32:21 +00:00
Josef Karthauser
a4d70fdb47
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
Josef Karthauser
ab6f5f0d9c
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
Josef Karthauser
d17bce98be
Fix the places that I missed last commit: 'vars' not 'var'.
2000-10-18 17:12:07 +00:00
Josef Karthauser
e77c53b0be
Correction: 'use vars ..' not 'use var'.
...
Submitted by: des
2000-10-17 15:50:22 +00:00
Josef Karthauser
fa0be99954
Build and install the perl.style(7) manual page.
2000-10-17 15:33:29 +00:00
Josef Karthauser
e79ac7ee3a
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
Josef Karthauser
3194300995
An initial draft of a style guide for perl scripts in the tree.
2000-10-17 02:51:03 +00:00
David E. O'Brien
c13ded1868
Add `isoC-99' to the list of availble abbreviations.
2000-10-11 19:30:41 +00:00
Murray Stokely
05f976924e
Fix typo : s/maintaince/maintenance/
2000-10-03 07:38:41 +00:00
Alexey Zelkin
2006c179e2
Document 'libusb' option for .Lb macro
2000-09-22 14:36:06 +00:00
David E. O'Brien
1a3ad32399
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
Brian Feldman
ba66454b69
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
Mike Pritchard
db3af44eb0
Remove some mis-leading text from the "Libraries" section.
2000-06-24 23:02:01 +00:00
Ruslan Ermilov
30592a1799
Document /usr/lib/aout.
...
PR: conf/18167
2000-06-07 07:41:09 +00:00
Ruslan Ermilov
c5f8035bad
/usr/mdec has gone 1.5 years ago.
2000-06-05 16:14:51 +00:00
Sheldon Hearn
f167d7fb3e
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
Alexey Zelkin
6d0a2eea64
Add libipsec to the list of available libraries
2000-05-04 17:58:22 +00:00
Alexey Zelkin
a8e2142b2f
Document .Fx',
.Nx' and `.Ox' macros as callable and parsable.
2000-05-04 16:25:27 +00:00
Alexey Zelkin
be08c04ecb
Add expanded information about .Lb macro
2000-04-23 14:50:38 +00:00
Alexey Zelkin
e4c2649e73
Add information about newly added .Lb macro
2000-04-23 14:49:22 +00:00
Nik Clayton
8596de5303
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
Sheldon Hearn
1111b49c35
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 Kennaway
2bfea7a2b0
Document OpenSSL directories.
2000-01-30 04:22:11 +00:00
Chris Costello
ab6afc855d
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
Nick Hibma
fcc56d9930
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
Alexey Zelkin
7547562461
Fix typos.
...
PR: docs/15781
Submitted by: Christian Weisgerber <naddy@mips.rhein-neckar.de>
2000-01-07 13:20:55 +00:00
Jun-ichiro itojun Hagino
1522ff5b28
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
Tim Vanderhoek
7ec24193b6
.Xr pkg_version 1
2000-01-02 17:55:03 +00:00
Jeroen Ruigrok van der Werven
bffd29ff1c
Fix some typo's.
...
PR: 15678
Submitted by: Christian Weisgerber <naddy@mips.rhein-neckar.de>
1999-12-27 11:02:43 +00:00
Daniel C. Sobral
65c9393d40
Add /boot.
1999-12-08 22:03:44 +00:00
Mike Pritchard
98fb084859
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
Bill Fumerola
da2440e826
A bullet in the head to pkg_manage references.
1999-11-26 22:12:12 +00:00
Alexey Zelkin
b844b13b6a
Fix file names in .FILES section.
...
Remove reference to obsolete files /us/src/share/tmac/README
1999-11-02 13:47:09 +00:00
Alexey Zelkin
af56842c46
Document .Ox and .Nx macros
1999-11-02 13:27:27 +00:00
Alexey Zelkin
385efa2c25
Document .St macro.
1999-11-02 13:23:56 +00:00
Alexey Zelkin
466f8f3f33
Fix invalid pathes in FILES section, mdoc(7)'fy
1999-10-30 14:10:31 +00:00
Mike Pritchard
6740f1c4ef
Correctly escape a macro call in the description of the .D1 macro.
...
Also use the correct macro (.D1, not .Dl) to format the text,
and in the example output.
PR: docs/14051
Submitted by: <andrew@ugh.net.au>
1999-09-30 14:39:22 +00:00
Alexey Zelkin
c6d6e7726f
Correct spelling : ascii -> ASCII
...
PR: docs/13702
Submitted by: Stephen J. Roznowski <sjr@home.com>
Reviewed by: mpp
1999-09-20 09:15:23 +00:00
Matthew Dillon
ad27d06632
Minor cleanups
...
Reviewed by: Matthew Dillon <dillon@backplane.com>
Submitted by: Alexey Zelkin <phantom@cris.net>
1999-09-19 05:30:12 +00:00
Matthew Dillon
d93b26d657
Bring security page uptodate, add more references, clarify some of
...
the comments, etc.
1999-09-18 18:21:38 +00:00
Alexey Zelkin
8b3038f872
Document .Ta macro.
...
Requested by: ru
Ok'ed by: mpp
1999-09-13 18:58:53 +00:00
Alexey Zelkin
19df0a6144
Fix typo: vi(8) -> vi(1)
...
Noticed by: ru
1999-09-13 18:38:53 +00:00
Alexey Zelkin
61f06d829c
Document .Ox and .Nx macros.
...
Reviewed by: mpp
1999-09-13 17:33:16 +00:00
Alexey Zelkin
a7299f79f8
Update to current state of filesystems layout (almost complete)
...
Stylize
PR: docs/13229
Reviewed by: mpp
1999-09-13 17:20:58 +00:00