mirror of
https://git.FreeBSD.org/src.git
synced 2024-12-16 10:20:30 +00:00
Scripts should contain a comment block describing what the script does.
This commit is contained in:
parent
f136389613
commit
c5bb0e9394
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=67318
@ -49,12 +49,25 @@ source tree.
|
||||
# Fill them so they look like real paragraphs.
|
||||
.Ed
|
||||
.Pp
|
||||
All scripts should follow the copyright block at the start of the
|
||||
script with a comment block that describes what the script does.
|
||||
.Bd -literal -offset 0i
|
||||
#!/usr/bin/perl -w
|
||||
|
||||
# COPYRIGHT
|
||||
# BLOCK
|
||||
|
||||
# This script processes an old kernel config file, which it gets on
|
||||
# stdin, and outputs a new style hints file to stdout.
|
||||
.Ed
|
||||
All scripts should use the
|
||||
.Fa strict
|
||||
module and run without warnings. For example:
|
||||
.Bd -literal -offset 0i
|
||||
#!/usr/bin/perl -w
|
||||
|
||||
# Copyright, description of what the script does, etc
|
||||
|
||||
use strict;
|
||||
...
|
||||
.Ed
|
||||
|
Loading…
Reference in New Issue
Block a user