Skip to content
Snippets Groups Projects
Select Git revision
  • f7d88d24c5a2b66b02770e2776fce72b5fd70193
  • panfrost/ci default
  • jakob-v5.4-patch
  • jakob-v5.4
  • jakob-4.19
  • drm-misc-next-with-blob
  • v5.3-hack-boot/ci
  • v5.3/ci
  • v5.2/ci
  • boot-time-improvement
  • jakob-v4.8
  • jakob-v4.9
12 results

mspec.c

Blame
  • kernel-doc 84.69 KiB
    #!/usr/bin/perl -w
    
    use strict;
    
    ## Copyright (c) 1998 Michael Zucchi, All Rights Reserved        ##
    ## Copyright (C) 2000, 1  Tim Waugh <twaugh@redhat.com>          ##
    ## Copyright (C) 2001  Simon Huggins                             ##
    ## Copyright (C) 2005-2012  Randy Dunlap                         ##
    ## Copyright (C) 2012  Dan Luedtke                               ##
    ## 								 ##
    ## #define enhancements by Armin Kuster <akuster@mvista.com>	 ##
    ## Copyright (c) 2000 MontaVista Software, Inc.			 ##
    ## 								 ##
    ## This software falls under the GNU General Public License.     ##
    ## Please read the COPYING file for more information             ##
    
    # 18/01/2001 - 	Cleanups
    # 		Functions prototyped as foo(void) same as foo()
    # 		Stop eval'ing where we don't need to.
    # -- huggie@earth.li
    
    # 27/06/2001 -  Allowed whitespace after initial "/**" and
    #               allowed comments before function declarations.
    # -- Christian Kreibich <ck@whoop.org>
    
    # Still to do:
    # 	- add perldoc documentation
    # 	- Look more closely at some of the scarier bits :)
    
    # 26/05/2001 - 	Support for separate source and object trees.
    #		Return error code.
    # 		Keith Owens <kaos@ocs.com.au>
    
    # 23/09/2001 - Added support for typedefs, structs, enums and unions
    #              Support for Context section; can be terminated using empty line
    #              Small fixes (like spaces vs. \s in regex)
    # -- Tim Jansen <tim@tjansen.de>
    
    # 25/07/2012 - Added support for HTML5
    # -- Dan Luedtke <mail@danrl.de>
    
    sub usage {
        my $message = <<"EOF";
    Usage: $0 [OPTION ...] FILE ...
    
    Read C language source or header FILEs, extract embedded documentation comments,
    and print formatted documentation to standard output.
    
    The documentation comments are identified by "/**" opening comment mark. See
    Documentation/kernel-doc-nano-HOWTO.txt for the documentation comment syntax.
    
    Output format selection (mutually exclusive):
      -docbook		Output DocBook format.
      -html			Output HTML format.
      -html5		Output HTML5 format.
      -list			Output symbol list format. This is for use by docproc.
      -man			Output troff manual page format. This is the default.
      -rst			Output reStructuredText format.
      -text			Output plain text format.
    
    Output selection (mutually exclusive):
      -export		Only output documentation for symbols that have been
    			exported using EXPORT_SYMBOL() or EXPORT_SYMBOL_GPL()
    			in the same FILE.
      -internal		Only output documentation for symbols that have NOT been
    			exported using EXPORT_SYMBOL() or EXPORT_SYMBOL_GPL()
    			in the same FILE.
      -function NAME	Only output documentation for the given function(s)
    			or DOC: section title(s). All other functions and DOC:
    			sections are ignored. May be specified multiple times.