d/freebsd-nq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
55,340 Commits 6 Branches 133 Tags 2.6 GiB
dceab8ea63
Commit Graph

5320 Commits

Author SHA1 Message Date
Ruslan Ermilov
68161b6b7d mdoc(7) police: fixed typo. 2000-11-22 13:49:11 +00:00
Ruslan Ermilov
ea3d1f093f mdoc(7) police: add the missing and required .Dd macro call. 2000-11-22 13:31:01 +00:00
Ruslan Ermilov
f4d874a1db mdoc(7) police: do not split author names in the AUTHORS section. 2000-11-22 09:35:58 +00:00
Ruslan Ermilov
2ba69799de 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
Ruslan Ermilov
ae9fd6288c mdoc(7) police: minor cleanup. 2000-11-22 08:19:15 +00:00
Alfred Perlstein
a0ae47cd48 Install DELAY(9). 2000-11-22 03:44:55 +00:00
Alfred Perlstein
0b0d531efb Document the DELAY() function. 2000-11-22 03:38:32 +00:00
Bosko Milekic
5d4050cc5d Add description of M_WRITABLE macro and new M_RDONLY flag. Try my best to 
conform to line break mdoc FreeBSD standards, although I am new to this.

Reviewed by: sheldonh
 2000-11-21 22:29:31 +00:00
Mark Murray
a28724c2c2 Add new man page to the mix. 2000-11-21 20:31:51 +00:00
Mark Murray
6323c703f7 Whitespace-only change. Tidy up, alphabetise and wrap. 2000-11-21 20:28:48 +00:00
Mark Murray
5855006767 Add a consistent API to a feature that most modern CPUs have; a fast 
counter register in-CPU.

This is to be used as a fast "timer", where linearity is more important
than time, and multiple lines in the linearity caused by multiple CPUs
in an SMP machine is not a problem.

This adds no code whatsoever to the FreeBSD kernel until it is actually
used, and then as a single-instruction inline routine (except for the
80386 and 80486 where it is some more inline code around nanotime(9).

Reviewed by:	bde, kris, jhb
 2000-11-21 19:55:21 +00:00
Ruslan Ermilov
a8e0cb75cc mdoc(7) police: fixed the section reference to the mdoc.samples(7). 2000-11-21 08:12:23 +00:00
Ruslan Ermilov
4b66483fd8 mdoc(7) police: use the new features of the Nm macro. 2000-11-20 18:41:33 +00:00
Ruslan Ermilov
7c7fb079b9 mdoc(7) police: use the new features of the Nm macro. 2000-11-20 16:52:27 +00:00
Sheldon Hearn
88927276f9 Document the libcompat entry for the .Lb macro. 
Submitted by:	phantom
 2000-11-20 16:14:08 +00:00
Sheldon Hearn
3d8a8abc28 Fix bug in rev 1.7: 
Use a paragraph marker (Pp) instead of a blank line.
 2000-11-20 16:06:00 +00:00
Sheldon Hearn
7061ab237b Fix a bug that's survived since rev 1.1: 
Don't mark the word "file" up as a pathname in "/etc/group file".  For
the sake of consistency with rev 1.18, use Nm instead of "Pa /etc/group"
and break "file" onto the next line.
 2000-11-20 16:05:09 +00:00
Sheldon Hearn
82bad969b8 Fix problems introduced in rev 1.16: 
* Hard sentence break.

* Using Nm for the file in the first paragraph made the use of Pa in the
  second paragraph look silly.
 2000-11-20 16:01:50 +00:00
Sheldon Hearn
1692a4f147 Fix problems introduced in rev 1.18: 
* Broken (sectionless) cross-reference to nsswitch.conf.
* Trailing whitespace.
 2000-11-20 15:56:22 +00:00
Sheldon Hearn
54c7f1620a Connect the new man4.alpha to the build. 2000-11-20 13:16:44 +00:00
Sheldon Hearn
1b2da3b0e4 Document the osf1 module. 
Submitted by:	gallatin
 2000-11-20 12:59:08 +00:00
Sheldon Hearn
5cd66fd5a0 Fix broken cross-reference to linprocfs(5). 2000-11-20 12:49:11 +00:00
Ben Smithurst
aabbf63eef Fix typo; s/demon/daemon/ 
PR:		22955, 22956
Submitted by:	Jimmy Olgeni <olgeni@uli.it>
 2000-11-20 10:15:38 +00:00
Doug Barton
09980f4348 Standardize spelling of "optimization" in comments 
PR:		conf/22622
Submitted by:	knu
 2000-11-19 20:12:06 +00:00
Ben Smithurst
d641426e5a Fix typo. 
PR:		22923
Submitted by:	Jimmy Olgeni <olgeni@uli.it>
 2000-11-18 20:19:26 +00:00
Ben Smithurst
f414612af0 Fix typos. 
PR:		22922
Submitted by:	Jimmy Olgeni <olgeni@uli.it>
 2000-11-18 20:18:34 +00:00
Ben Smithurst
7a41bbd47b Fix another typo. 
PR:		22924
Submitted by:	Jimmy Olgeni <olgeni@uli.it>
 2000-11-18 20:16:47 +00:00
Ruslan Ermilov
218d216271 mdoc(7) police: eliminate warnings. 2000-11-17 15:40:57 +00:00
Ruslan Ermilov
251c176f41 mdoc(7) police: use certified section headers wherever possible. 2000-11-17 11:44:16 +00:00
Ben Smithurst
0381c6e5ba Fix typos. 
PR:		22901, 22902
Submitted by:	Jimmy Olgeni <olgeni@uli.it>
 2000-11-17 09:16:29 +00:00
Ben Smithurst
d5c58b9b78 fix typo; compliment -> complement. 
PR:		22840
Submitted by:	Jimmy Olgeni <olgeni@uli.it>
 2000-11-16 12:19:19 +00:00
Ben Smithurst
3e8a697e32 remove trailing fullstop from SEE ALSO. 
Reviewed by:	grog
 2000-11-16 11:42:11 +00:00
Archie Cobbs
6e8d625628 New netgraph node type ng_one2many(4). 2000-11-16 05:58:33 +00:00
Archie Cobbs
c3427a5cc8 Add ichsmb.4 to the list. 2000-11-16 03:43:56 +00:00
Alfred Perlstein
a984db451a install/build accf_* manpages 2000-11-16 00:57:52 +00:00
Alfred Perlstein
16fb0774c2 Xref accf_http and accf_data 2000-11-15 22:54:06 +00:00
Alfred Perlstein
9d6bbf9b1e Document the accf_data accept filter: "dataready" 2000-11-15 22:53:02 +00:00
Alfred Perlstein
9d3a32814d Document the accf_http accept filter "httpready". 2000-11-15 22:46:21 +00:00
Ben Smithurst
6fe89339b9 remove fullstops from the end of .Xr lines in SEE ALSO sections. 2000-11-15 16:00:07 +00:00
Ben Smithurst
b02eeb5c33 Add a newline character at the end of this file, it was missing which 
resulted in ugly errors from 'diff'.
 2000-11-15 13:34:41 +00:00
Julian Elischer
99fcf9836a Slight cleanups after comments from John Hay (Thanks!) 
Also add more comments.
 2000-11-15 12:05:21 +00:00
Ruslan Ermilov
192d7a5f22 Spell the author's name correctly. 2000-11-14 13:43:43 +00:00
Ruslan Ermilov
b82f5db0ac Spell the des's name correctly. 2000-11-14 13:19:26 +00:00
Ruslan Ermilov
8e8536e1c2 Spell the sos's name correctly. 2000-11-14 13:09:12 +00:00
Ruslan Ermilov
b5c508fba3 Use Fx macro wherever possible. 2000-11-14 11:20:58 +00:00
Brian Feldman
087815f8bc Disable /usr/bin/ssh being setuid root by default. Let the variable 
ENABLE_SUID_SSH being defined reenable it for those that want it.

This follows discussion favoring the change from September.  It
is not usually necessary to be setuid root, possibly less safe,
and less convenient (cannot use $HOSTALIASES, for example).

Submitted by:	jedgar
 2000-11-14 04:42:25 +00:00
Ben Smithurst
cffeda3ce2 fix a typo; abso -> also 
PR:		22806
Submitted by:	Jimmy Olgeni <olgeni@uli.it>
 2000-11-13 20:36:06 +00:00
John Baldwin
ab7e1991c0 Beef up the description of the kernel thread API. 
Reviewed by:	sheldonh, jasone
 2000-11-13 20:34:20 +00:00
John Baldwin
dc4e9f1a03 Describe the new software interrupt thread functionality. 
Reviewed by:	sheldonh, jasone
 2000-11-13 20:18:42 +00:00
John Baldwin
eaca618337 Add a manpage to document the atomic operations including a quick treatment 
of memory barriers and the newish atomic variants that include them.

Reviewed by:	sheldonh
 2000-11-13 20:08:17 +00:00
David Malone
9704bfcdfb Change a "xlint(1)" to a ".Xr lint 1" and add a reference in the see also 
section.
 2000-11-13 16:18:46 +00:00
Mike Pritchard
ec9a57e8ac 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
Sheldon Hearn
6cfaa4a7de Sort NAMES section and separate Nm arguments from trailing punctuation. 2000-11-13 13:12:44 +00:00
Nik Clayton
cfcae32408 Remove the comment about the occupied Palestinian territory not having a 
code designation, as it's code 275.

Include the URL of the ISO3166 Maintenance Agency.

Remove FX, it's been deprecated.

Update the Palestine entry with the correct code and description.

PR:		     docs/22570
Submitted by:	     Laurent Wacrenier <lwa@victor.teaser.fr>
 2000-11-12 16:27:48 +00:00
Julian Elischer
7dd17df71d Share one devclass between ISA and PCI sections 
This will ensure unit numbers will co-ordinate between them
 2000-11-12 10:46:38 +00:00
Ben Smithurst
422d857731 * Fix inconsistency between "int" and "num"; as far as I can see they mean 
the same thing in this context.
* Only include one fullstop in the SEE ALSO line.

PR:		22658
Submitted by:	Yoshihiko Sarumaru <mistral@imasy.or.jp>
 2000-11-11 19:16:05 +00:00
Julian Elischer
e904636ad4 Add basic PCI capability 
Not sure how unit numbers are carried across between
PCI and ISA though.. maybe there should be only one devclass between the two?
 2000-11-11 09:49:49 +00:00
Ruslan Ermilov
726b61ab5f Avoid use of direct troff requests in mdoc(7) manual pages. 2000-11-10 17:46:15 +00:00
Archie Cobbs
3918c80b80 Now almost all Ethernet drivers support bridging. 
Noticed by:	gallatin
 2000-11-10 16:58:13 +00:00
Jeroen Ruigrok van der Werven
b2a80a67da Document that the 3c905C-TX is supported aside from Dell equipment. 2000-11-10 15:35:37 +00:00
Ruslan Ermilov
25214d26b5 Fixed typo in description of ENABLE_SUIDPERL. 2000-11-10 10:46:11 +00:00
Sheldon Hearn
25f1a2e9f9 Miscellaneous content fixes: 
* xref sysctl
* do not mark kern.ipc.mbuf_wait up as a function argument.
* do not mix case of function argument names
* a mbuf -> an mbuf
* if -> whether
* typos
 2000-11-10 10:22:49 +00:00
Sheldon Hearn
e73145f651 Whitespace only: fix hard sentence breaks now, before people really 
get stuck into this page.
 2000-11-10 10:08:34 +00:00
John Baldwin
c5f3b30e68 Replace non-existent 'mtx_t' typedef'd type with 'struct mtx'. 2000-11-10 01:51:55 +00:00
Alfred Perlstein
ce900f0398 Manpage incorrectly states that STAILQ_REMOVE_HEAD takes an arg 
called 'elm'.  It doesn't take an arg 'elm', it simply removes the
element at the head of the list.
 2000-11-09 23:34:39 +00:00
Julian Elischer
4a3a6ee4c8 Add more sample code having read the daemnnews article (August 2000) 2000-11-09 18:55:44 +00:00
Jeroen Ruigrok van der Werven
6913c296f7 Change .Os FreeBSD 5.0 to .Os FreeBSD. 
PR:		22684
Submitted by:	Akinori YAMADA <yamada-a@nextcom.co.jp>
 2000-11-09 05:05:17 +00:00
Julian Elischer
87e78fdf4c Having figured out a bit more of the new-bus puzzle 
I have added support for finding non-PNP devices to this
sample loadable ISA driver.
PCI support will come later.

If someone with a clue about newbus were to look it over it would be
really cool.
 2000-11-08 21:54:28 +00:00
Jordan K. Hubbard
8b4c822db0 Add commented-out entries for FTP_PROXY and HTTP_PROXY so those behind 
firewalls have examples to work from.

Requested by:	chein
 2000-11-08 07:30:27 +00:00
Warner Losh
322040325e Add sn to files to install 2000-11-08 06:32:40 +00:00
Warner Losh
c1ecac83cc simple sn man page, since we're missing one right now 2000-11-08 06:30:55 +00:00
Ruslan Ermilov
888bb0ddd2 Fixed typo: .ar -> .Ar 2000-11-06 15:18:56 +00:00
Ruslan Ermilov
a9a88e5db1 -mdoc cleanup: replace custom .ES/.EE macros with literal display. 2000-11-06 12:37:45 +00:00
Ruslan Ermilov
97781a0aa9 Fixed typo: .PB -> .El 2000-11-06 12:19:35 +00:00
Ruslan Ermilov
672300f7c7 Fixed typo: .SY -> .Sy 2000-11-06 09:17:44 +00:00
Paul Saab
9193b12844 MF4: Add LOADER_TFTP_SUPPORT make.conf flag. 2000-11-04 08:43:13 +00:00
David E. O'Brien
a450541bfc State that using optimization level above -O for kernel builds isn't smart. 2000-11-02 22:14:59 +00:00
Sheldon Hearn
9fde3dc5ba Update the SYNOPSIS to reflect that the driver can be loaded as a module. 
While here, I also updated the kernel config style, although I wouldn't
recommend doing this for the whole of section 4 yet, since our kernel
config style is still in a state of flux.
 2000-11-02 14:23:53 +00:00
Bosko Milekic
bfd597212a Fixup some wrong statements in the new mbuf(9) man page. 
Also introduce a bunch of (missed?) macros and functions.
This man page still needs a lot of work, most likely a re-ordering
of the macros/functions, and a more complete, more accurate, listing of
available routines.
A good and worthy start nonetheless.
 2000-11-01 23:02:19 +00:00
Hellmuth Michaelis
4ad3090e49 Ooops, forgot to add the originator for the last FAQ entry 2000-11-01 14:08:58 +00:00
Hellmuth Michaelis
2345588750 Add entry to the FAQ 2000-11-01 14:06:46 +00:00
Mike Pritchard
86907e17ce Mdoc style fixes. 
PR:		docs/22445
 2000-11-01 11:17:33 +00:00
Ralf S. Engelschall
aad65d1ca2 Don't use the old URL to the GNU ftp location any more: 
ftp://prep.ai.mit.edu/pub/gnu/ -> ftp://ftp.gnu.org/gnu/
 2000-11-01 10:24:08 +00:00
David E. O'Brien
5558b041c8 Use test -z rather than -n. 
Submitted by:	bde
 2000-11-01 07:09:38 +00:00
John Baldwin
7e56ee52c8 Catch up to mutexes becoming MI: machine/mutex.h -> sys/mutex.h 2000-11-01 00:39:27 +00:00
Jeroen Ruigrok van der Werven
29c9277956 Fix a fundamental error. The device is not owned by the parent 
bus before allocation.  The resource is.

Asked about by:	julian on -current
Verified by:	msmith
 2000-10-31 13:16:47 +00:00
Scott Long
96b8a53d48 Update to reflect that the XPT device can accept path inquiry commands. 
Reviewed by:	gibbs
 2000-10-30 23:33:39 +00:00
Sheldon Hearn
6296795713 Whitespace only: 
* Remove hard sentence breaks.
 * Remove trailing whitespace.
 * Separate macro arguments from trailing punctuation with whitespace.
 2000-10-30 19:49:26 +00:00
Ruslan Ermilov
dc5a40409d Add pfil.9 manpage to build after a repository copy. 2000-10-30 09:16:18 +00:00
Poul-Henning Kamp
cf9fa8e725 Move suser() and suser_xxx() prototypes and a related #define from 
<sys/proc.h> to <sys/systm.h>.

Correctly document the #includes needed in the manpage.

Add one now needed #include of <sys/systm.h>.
Remove the consequent 48 unused #includes of <sys/proc.h>.
 2000-10-29 16:06:56 +00:00
Jeroen Ruigrok van der Werven
47f9d42dab Break a line more appropriately. 2000-10-29 13:37:13 +00:00
Jeroen Ruigrok van der Werven
b705e4512b Whitespace only commit. 2000-10-29 13:33:57 +00:00
Jeroen Ruigrok van der Werven
eae4fc8ef3 Update the twe manpage to correspond with the latest source changes. 
Submitted by:	msmith
 2000-10-29 13:31:24 +00:00
Chris D. Faulhaber
2d45aed6bc Remove obsolete /dev/drum references 
Reviewed by:	alex, asmodai, billf
 2000-10-29 12:19:52 +00:00
Matt Jacob
da731adabc fix minor oops in new data compression page definition 2000-10-29 00:54:59 +00:00
Nik Clayton
54b93a1055 RBG -> RGB 
PR:		docs/21724
Submitted by:	TOGAWA Satoshi <toga@puyo.org>
 2000-10-28 23:25:41 +00:00
Matt Jacob
14a7806366 Add 3 SCSI-3 bits for Sequential Access Device Congifuration Page. 
Add Data Compression Page (SCSI-3). Add some clarifying comments
at the top of the file that say what the syntax is.
 2000-10-28 22:47:47 +00:00
MIHIRA Sanpei Yoshiro
33eb563d67 add PC-Card melody beep(PC Card bus, kludge version) 
Original idea from:	PAO3
 2000-10-28 13:35:34 +00:00
Alexander Langer
b7f4c6bf0e Use EX_USAGE in an example, as the SAME manual page describes a 
few lines higher.

PR:		22371
Submitted by:	andrew@ugh.net.au
 2000-10-28 10:02:23 +00:00
Jeroen Ruigrok van der Werven
8c615a5285 Add some more information to the AUTHORS section. 
Remove unnecessary duplication of asr after the .Nm macro.
 2000-10-28 09:56:34 +00:00
Mike Pritchard
096ed6644a Typo fix. 2000-10-27 20:55:15 +00:00
Matt Jacob
f2998370b7 update man page to reflect new support 2000-10-27 16:12:53 +00:00
Jeroen Ruigrok van der Werven
e87b9f2824 Use FreeBSD.org, not freebsd.org, as has been the precedent. 2000-10-27 16:05:39 +00:00
Jeroen Ruigrok van der Werven
90165ebba8 Please welcome the asr manpage [no, not alt.sysadmin.recovery], but 
the Adaptec SCSI RAID cards.

Submitted by:	msmith, scottl, Mark Salyzyn
 2000-10-27 15:54:34 +00:00
John Baldwin
7dbdc1bff4 Add in MLINKS for all of the various mutex functions to mutex.9 2000-10-26 23:54:10 +00:00
John Baldwin
2c3d0ee6f4 - Document MUTEX_DECLARE and MTX_COLD 
- Clean up some minor nits
 2000-10-26 23:53:12 +00:00
John Baldwin
26fdc7e05b Add a note that the spl() API is deprecated in favor of mutexes. 2000-10-26 23:30:01 +00:00
Nik Clayton
de06f907d1 Add a prototype mbuf.9 man page. Probably needs work, but it's a good 
start.

PR:             docs/22053
Submitted by:   Yar Tikhiy <yar@comp.chem.msu.su>
 2000-10-26 23:15:47 +00:00
Nik Clayton
b69358a992 Remove a doubled "in the". 
PR:             docs/22140
Submitted by:   Cyrille Lefevre <clefevre@citeweb.net>
 2000-10-26 23:13:10 +00:00
Nik Clayton
c45b509bf4 Update to include a link to the referenced papers when PRINTERDEVICE=html 
PR:             docs/22140
Submitted by:   Cyrille Lefevre <clefevre@citeweb.net>
 2000-10-26 23:12:12 +00:00
Gregory Neil Shapiro
d1ba25f456 Add a MAINTAINER= line so people know who to blame 2000-10-26 23:02:36 +00:00
Julian Elischer
96305e8f3e Add copyright to skeleton. 2000-10-26 21:53:37 +00:00
Julian Elischer
45ddd9af7d some more cleanups 
still need to handle non-PNP devices properly.
 2000-10-26 21:37:38 +00:00
Jeroen Ruigrok van der Werven
7e06ffaa30 Add and install the uscanner manpage. 
Reviewed by:	n_hibma
Prodded by:	grog
 2000-10-26 15:36:36 +00:00
Jeroen Ruigrok van der Werven
eddc45e797 Update @freebsd.org email addresses to @FreeBSD.org as is the 
precedent.
 2000-10-26 15:30:44 +00:00
Garrett Wollman
3b4d27f6d7 Merge from vendor branch. 2000-10-25 19:36:49 +00:00
Garrett Wollman
10b59911e8 This commit was generated by cvs2svn to compensate for changes in r67575, 
which included commits to RCS files with non-trunk default branches.
 2000-10-25 19:33:50 +00:00
Garrett Wollman
5d07889871 ../changes 2000-10-25 19:33:50 +00:00
Julian Elischer
d1d3a97409 Slowly add more functionality as I learn more about newbus etc. 2000-10-25 15:08:11 +00:00
Søren Schmidt
169d20b2ce Add the ATA_ENABLE_TAGS option 2000-10-25 08:25:37 +00:00
Archie Cobbs
c06992e558 Build the ISC library as libisc. This library comes as part of the 
bind distribution, but until now was not being built as a separate
entity. For documentation, see these man pages:

assertions(3), eventlib(3), heap(3), logging(3), memcluster(3), tree(3).

Reviewed by:	jdp
 2000-10-24 20:10:25 +00:00
Julian Elischer
ed2f9d4e88 Change archie's and my email addresses from Whistle.com to FreeBSD.org 2000-10-24 18:01:45 +00:00
Julian Elischer
45b4f5af9e First effort at bringing these up-to-date. 
This creates a skeleton ISA device driver.
I don't pretend that it's fully correct or even opitimal
but it at least creates (and compiles) a 'clean' ISA driver.

Hopefully PCI/PCCARD/etc. support will be added when I understand it.
Unlike the old version this just creates a module. The old one tried to
create a new kernel with the driver to be tested.
 2000-10-24 16:45:58 +00:00
Mike Pritchard
2e283b0a0c Correct the description of a few options to reflect that commands and/or 
the results that they actualy use/generate.

PR:		docs/22267
Submitted by:	SUZUKI Koichi <koich@cac.co.jp>
 2000-10-24 13:54:17 +00:00
Akinori MUSHA
82494980f2 Add MASTER_SITE_MOZILLA and MASTER_SITE_XEMACS. 2000-10-24 12:37:52 +00:00
Mark Murray
e5e600c900 Add some very crude man pages to try to induce folk to work on them. 
Agreed to work on them:	jasone
 2000-10-24 03:33:24 +00:00
Andrey A. Chernov
c4a1cfd667 Fix %c 2000-10-23 14:31:27 +00:00
Akinori MUSHA
241d880ebb It is bsd.sites.mk one should look for a full list of default sites, 
not bsd.port.mk anymore.

Add MASTER_SITE_XFREE, MASTER_SITE_RINGSERVER, MASTER_SITE_TCLTK and
MASTER_SITE_RUBY.

Document and add MASTER_SORT_REGEX.
 2000-10-22 12:09:16 +00:00
Wolfram Schneider
04ec069eb0 update URL and copyright 2000-10-20 18:27:53 +00:00
Wolfram Schneider
7089ec586f Added upcoming FreeBSD 4.2 2000-10-20 18:21:44 +00:00
Poul-Henning Kamp
1921a06d6a Introduce the M_ZERO flag to malloc(9) 
Instead of:

        foo = malloc(sizeof(foo), M_WAIT);
        bzero(foo, sizeof(foo));

You can now (and please do) use:

        foo = malloc(sizeof(foo), M_WAIT | M_ZERO);

In the future this will enable us to do idle-time pre-zeroing of
malloc-space.
 2000-10-20 17:54:55 +00:00
Mike Pritchard
18157703d5 Remove bogus xref. 
PR:		docs/22125
Submitted by:	Keith Jones <keith@sse0691.bri.hp.com>
 2000-10-20 05:59:51 +00:00
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
Roger Hardiman
0eed4af9fa Fix error in sample code in the man page 2000-10-17 08:27:18 +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
Doug Rabson
0d409bfdac Add section for building ia64 kernels. 2000-10-16 20:04:52 +00:00
Mark Murray
67297998c8 Add a man page for part of the PRNG API. 2000-10-14 16:16:42 +00:00
David E. O'Brien
c13ded1868 Add `isoC-99' to the list of availble abbreviations. 2000-10-11 19:30:41 +00:00
Joseph Koshy
1f49176099 Minor doc tweaks: reorder the "SEE ALSO" section alphabetically; add 
punctuation.
 2000-10-11 10:46:12 +00:00