Package conary :: Package build :: Module build :: Class JavaDoc
[hide private]
[frames] | no frames]

Class JavaDoc

source code

  action.Action --+                
                  |                
action.RecipeAction --+            
                      |            
            BuildAction --+        
                          |        
                _FileAction --+    
                              |    
                            Doc --+
                                  |
                                 JavaDoc

NAME

r.JavaDoc() - Installs documentation files

SYNOPSIS

r.JavaDoc(filename, [dir=/path])

DESCRIPTION

The r.JavaDoc() class is called from within a Conary recipe to Install documentation files from the %(builddir)s into %(destdir)s/%(thisjavadocdir)s.

Specify a single file or directory of files for the filename parameter. The dir=path keyword argument can be used to create a subdirectory of %(destdir)s/%(thisjavadocdir)s where files may subsequently be located.

KEYWORDS

The r.JavaDoc() class accepts the following keywords:

dir : Specify a subdirectory to create before placing documentation files into it.

package : (None) If set, must be a string that specifies the package (package='packagename'), component (package=':componentname'), or package and component (package='packagename:componentname') in which to place the files added while executing this command. Previously-specified PackageSpec or ComponentSpec lines will override the package specification, since all package and component specifications are considered in strict order as provided by the recipe.

EXAMPLES

r.JavaDoc('doc/kbd.FAQ*.html', dir='html')

Demonstrates installing doc/kbd.FAQ*.html files into the html subdirectory after first creating the html subdirectory using r.JavaDoc().

r.JavaDoc('pam_smb.conf.example')

Demonstrates using r.JavaDoc to place the file pam_smb.conf.example into %(destdir)s/%(thisjavadocdir)s.

r.JavaDoc("html/")

Demonstrates using r.JavaDoc to place the subdirectory html from %(builddir)s into %(destdir)s/%(thisjavadocdir)s.

Instance Methods [hide private]
 
do(self, macros)
Do the build action
source code

Inherited from Doc: __init__

Inherited from _FileAction: chmod, setComponents

Inherited from BuildAction: doAction, initManifest, missingFiles

Inherited from action.RecipeAction: doPrep, doSuggestAutoBuildReqs, init_error

Inherited from action.Action: addArgs

Inherited from action.Action (private): _applyDefaults

Class Variables [hide private]

Inherited from Doc: keywords, useExplicitManifest

Method Details [hide private]

do(self, macros)

source code 
Do the build action
Overrides: Doc.do