1
0
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:
Josef Karthauser 2000-10-19 18:18:35 +00:00
parent f136389613
commit c5bb0e9394
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=67318

View File

@ -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