coar 01/06/22 06:02:37 Modified: apidoc APIdict.pm Log: Re-order some of the routines, plus minor enhancements Revision Changes Path 1.4 +47 -24 httpd-docs-1.3/apidoc/APIdict.pm Index: APIdict.pm =================================================================== RCS file: /home/cvs/httpd-docs-1.3/apidoc/APIdict.pm,v retrieving revision 1.3 retrieving revision 1.4 diff -u -u -r1.3 -r1.4 --- APIdict.pm 2001/05/16 11:23:23 1.3 +++ APIdict.pm 2001/06/22 13:02:36 1.4 @@ -5,6 +5,9 @@ # # Edit history: # +# 2001-06-19 Ken Coar +# Added some documentation, and added xref-counts to the stats result. +# # 2001-05-04 Ken Coar # Add 'hyperlink' Boolean setting. # @@ -79,6 +82,9 @@ return $wip; } +# +# Return the one-character category (type) of the specified entity. +# sub category { my($self, $item) = @_; my($rtype); @@ -90,12 +96,19 @@ return uc($rtype); } +# +# Return the human-readable name of a category (such as 'Routine' or +# 'Constant'). +# sub category_name { my($self, $prefix) = @_; return $Prefix{uc($prefix)}; } +# +# Return an unsorted array of the names of defined 'cell' entities. +# sub cell_list { my($self, $item) = @_; @@ -112,6 +125,9 @@ return &writefile($self, $DictFile); } +# +# Return an unsorted array of the names of defined constant entities. +# sub constant_list { my($self, $item) = @_; @@ -195,6 +211,10 @@ return join("", @Dictionary); } +# +# Return an unsorted array of the names of all defined entities, +# irrespective of their categories/types. +# sub entity_list { my($self, $item) = @_; @@ -207,6 +227,12 @@ return $Example{$item}; } +sub see_also { + my($self, $item) = @_; + + return $SeeAlso{$item}; +} + # # Expand any xref references in a see-also list. # @@ -289,6 +315,24 @@ return keys(%Macro); } +sub routine_list { + my($self, $item) = @_; + + return keys(%Routine); +} + +sub xref_list { + my($self, $item) = @_; + + return keys(%Xref); +} + +sub structure_list { + my($self, $item) = @_; + + return keys(%Structure); +} + # # Create a unique item name. This seems weird for a dictionary, but it # allows the module to be used to record the same information about other @@ -312,24 +356,6 @@ return $item; } -sub routine_list { - my($self, $item) = @_; - - return keys(%Routine); -} - -sub see_also { - my($self, $item) = @_; - - return $SeeAlso{$item}; -} - -sub structure_list { - my($self, $item) = @_; - - return keys(%Structure); -} - # # Read a dictionary file and load the arrays. # @@ -444,6 +470,7 @@ # "macros" # "structures" # "constants" +# "reference_lists" # sub statistics { my(@counter, %stats) = (); @@ -460,6 +487,8 @@ $stats{"cells"} = $#counter + 1; @counter = keys(%Structure); $stats{"structures"} = $#counter + 1; + @counter = keys(%Xref); + $stats{"reference_lists"} = $#counter + 1; $stats{"lines"} = $#Dictionary + 1; return %stats; } @@ -501,12 +530,6 @@ $dirty = 0; @uncommitted = (); return 0; -} - -sub xref_list { - my($self, $item) = @_; - - return keys(%Xref); } #
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]