From f730088bbcb7e0270a590a7161b0f8d8d50386d7 Mon Sep 17 00:00:00 2001 From: Eric Andersen Date: Tue, 6 Apr 2004 15:26:25 +0000 Subject: Eliminate all trace of the sgml based docs. It was a noble effort, but it just never worked out... --- docs/autodocifier.pl | 39 +++++++++------------------------------ 1 file changed, 9 insertions(+), 30 deletions(-) (limited to 'docs/autodocifier.pl') diff --git a/docs/autodocifier.pl b/docs/autodocifier.pl index e1101d9d0..eee67cf09 100755 --- a/docs/autodocifier.pl +++ b/docs/autodocifier.pl @@ -94,17 +94,6 @@ sub pod_for_usage { ; } -# FIXME | generate SGML for an applet -sub sgml_for_usage { - my $name = shift; - my $usage = shift; - return - "\n". - " $name\n". - "\n" - ; -} - # the keys are applet names, and # the values will contain hashrefs of the form: # @@ -124,7 +113,6 @@ my %opt; GetOptions( \%opt, "help|h", - "sgml|s", "pod|p", "verbose|v", ); @@ -133,7 +121,6 @@ if (defined $opt{help}) { print "$0 [OPTION]... [FILE]...\n", "\t--help\n", - "\t--sgml\n", "\t--pod\n", "\t--verbose\n", ; @@ -163,10 +150,6 @@ foreach (@ARGV) { # generate structured documentation my $generator = \&pod_for_usage; -if (defined $opt{sgml}) { - $generator = \&sgml_for_usage; -} - foreach my $applet (sort keys %docs) { print $generator->($applet, $docs{$applet}); } @@ -191,18 +174,18 @@ Example: =head1 DESCRIPTION -The purpose of this script is to automagically generate documentation -for busybox using its usage.h as the original source for content. -It used to be that same content has to be duplicated in 3 places in -slightly different formats -- F, F, and -F. This was tedious and error-prone, so it was +The purpose of this script is to automagically generate +documentation for busybox using its usage.h as the original source +for content. It used to be that same content has to be duplicated +in 3 places in slightly different formats -- F, +F. This was tedious and error-prone, so it was decided that F would contain all the text in a machine-readable form, and scripts could be used to transform this text into other forms if necessary. -F is one such script. -It was based on a script by Erik Andersen -which was in turn based on a script by Mark Whitley +F is one such script. It is based on a script by +Erik Andersen which was in turn based on a +script by Mark Whitley =head1 OPTIONS @@ -216,10 +199,6 @@ This displays the help message. Generate POD (this is the default) -=item B<--sgml> - -Generate SGML - =item B<--verbose> Be verbose (not implemented) @@ -292,4 +271,4 @@ John BEPPU =cut -# $Id: autodocifier.pl,v 1.25 2004/03/13 08:32:14 andersen Exp $ +# $Id: autodocifier.pl,v 1.26 2004/04/06 15:26:25 andersen Exp $ -- cgit v1.2.3