Skip to content
Snippets Groups Projects
Forked from Reform / reform-boundary-uboot
25575 commits behind the upstream repository.
  • Masahiro Yamada's avatar
    7424145f
    kbuild: consolidate version and timestamp headers generation · 7424145f
    Masahiro Yamada authored
    
    - Generate include/generated/{timestamp.h, version.h}
       more simply by using filechk rule.
    
     - Add $(UBOOTRELEASE) variable and re-write u-boot.imx rule
       more simply.
    
     - Rename U_BOOT_VERSION in Makefile to UBOOTVERSION
    
       Before this commit, the same variable name, "U_BOOT_VERSION"
       was used for two different strings.
    
       One of them was defined in Makefile.
       It takes the form like "2014.01-rc1" and used in
       makefiles and script files.
    
       The other is defined in include/generated/version.h
       It takes the form like "U-Boot 2014.01-rc1-00010-gbe6d426-dirty"
       and used in C and Aseembler.
    
       It is confusing when grepping the source tree. So, this commit
       renames the former to UBOOTVERSION.
    
    Signed-off-by: default avatarMasahiro Yamada <yamada.m@jp.panasonic.com>
    7424145f
    History
    kbuild: consolidate version and timestamp headers generation
    Masahiro Yamada authored
    
    - Generate include/generated/{timestamp.h, version.h}
       more simply by using filechk rule.
    
     - Add $(UBOOTRELEASE) variable and re-write u-boot.imx rule
       more simply.
    
     - Rename U_BOOT_VERSION in Makefile to UBOOTVERSION
    
       Before this commit, the same variable name, "U_BOOT_VERSION"
       was used for two different strings.
    
       One of them was defined in Makefile.
       It takes the form like "2014.01-rc1" and used in
       makefiles and script files.
    
       The other is defined in include/generated/version.h
       It takes the form like "U-Boot 2014.01-rc1-00010-gbe6d426-dirty"
       and used in C and Aseembler.
    
       It is confusing when grepping the source tree. So, this commit
       renames the former to UBOOTVERSION.
    
    Signed-off-by: default avatarMasahiro Yamada <yamada.m@jp.panasonic.com>
kernel-doc 71.66 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>

#
# This will read a 'c' file and scan for embedded comments in the
# style of gnome comments (+minor extensions - see below).
#

# Note: This only supports 'c'.

# usage:
# kernel-doc [ -docbook | -html | -html5 | -text | -man | -list ]
#            [ -no-doc-sections ]
#            [ -function funcname [ -function funcname ...] ]
#            c file(s)s > outputfile
# or
#            [ -nofunction funcname [ -function funcname ...] ]
#            c file(s)s > outputfile
#
#  Set output format using one of -docbook -html -html5 -text or -man.
#  Default is man.
#  The -list format is for internal use by docproc.
#
#  -no-doc-sections
#	Do not output DOC: sections
#
#  -function funcname
#	If set, then only generate documentation for the given function(s) or
#	DOC: section titles.  All other functions and DOC: sections are ignored.
#
#  -nofunction funcname
#	If set, then only generate documentation for the other function(s)/DOC: