summaryrefslogtreecommitdiff
path: root/autodoc/source/exes/adc_uni/spec-CommandLine.txt
diff options
context:
space:
mode:
Diffstat (limited to 'autodoc/source/exes/adc_uni/spec-CommandLine.txt')
-rw-r--r--autodoc/source/exes/adc_uni/spec-CommandLine.txt197
1 files changed, 0 insertions, 197 deletions
diff --git a/autodoc/source/exes/adc_uni/spec-CommandLine.txt b/autodoc/source/exes/adc_uni/spec-CommandLine.txt
deleted file mode 100644
index 20560e719fa6..000000000000
--- a/autodoc/source/exes/adc_uni/spec-CommandLine.txt
+++ /dev/null
@@ -1,197 +0,0 @@
-#
-# This file is part of the LibreOffice project.
-#
-# This Source Code Form is subject to the terms of the Mozilla Public
-# License, v. 2.0. If a copy of the MPL was not distributed with this
-# file, You can obtain one at http://mozilla.org/MPL/2.0/.
-#
-# This file incorporates work covered by the following license notice:
-#
-# Licensed to the Apache Software Foundation (ASF) under one or more
-# contributor license agreements. See the NOTICE file distributed
-# with this work for additional information regarding copyright
-# ownership. The ASF licenses this file to you under the Apache
-# License, Version 2.0 (the "License"); you may not use this file
-# except in compliance with the License. You may obtain a copy of
-# the License at http://www.apache.org/licenses/LICENSE-2.0 .
-#
-
- Command Line Options
- --------------------
-
-autodoc [-v <level>]
- -html <out>
- [-extroot <externroot> -extnsp <externnamespace>]
- -lg <proglang>
- [-t <sourcetree>[ <sourcetree> ...]
- [-d <sourcedir>[ <sourcedir> ...]
- [-f <sourcefile>[ <sourcefile> ...]
-
-
- -html <OutputDirectory>
- Directory where the output will be created.
-
- -lg <ProgrammingLanguage>
- Allowed values: "idl"
-
- -extroot <externroot>
- Only together with "-lg idl" and -extnsp.
- Links to code entities not found within the current parsed
- code, will be linked there, but only if -extnsp is given and
- the linked entity is in the given namespace.
- <externroot> is a http link, it needs no "http://" at the
- beginning nor slash at the end.
-
- -extnsp <externnamespace>
- Only together with "-lg idl" and -extroot.
- If a code entity is not found in the current parsed code, but
- dwells in the namespace (or its children) given here, it is
- linked into the locátion given by -extroot.
- <externnamespace> is an absolute qualified namespace,
- starting with "::".
-
- -t <SourceTree>*
- Directory with all subdirectories.
-
- -d <SourceDirectory>*
- Directory without subdirectories.
-
- -f <SourceFile>*
- Any file. Here also files with extensions not matching the
- language are accepted.
-
- -I:<ResponseFile>
- Each line in the response file has to have one command line
- option. No whitespace at start of line.
-
- -C:<ConfigurationFile>
- Format see below.
-
- -v <VerboseLevel>
- Only for debugging. Bits 1, 2 and 4 in any combination give
- different output.
-
- -h
- Displays help.
- -?
- Displays help.
-
-
-
-
-
- Command Line Options especially for the OpenOffice.org SDK
- ----------------------------------------------------------
-
- -dvgroot <DevelopersGuide>
- Root directory of the SDK Developers Guide.
-
- -dvgfile <ReferenceFile>
- File with references to the SDK Developers Guide.
-
- -sincefile <@since-AssociationFile>
- File that maps OpenOffice versions to the wished displayed version names.
-
- -idlref <IdlDocumentationRoot> <Namespace[,Namespace ...]>
- Gives the outputdirectory of an IDL documentation, where
- symbols not found in the currently parsed namespaces of C++
- can be found.
-
-
-
- Configure File Format
- ---------------------
-
-<AutodocConfiguration>
- <RepositoryName></RepositoryName>
- // Base name of the binary repository files.
- // Has to be a valid file name.
-
- <HtmlOutputTitle></HtmlOutputTitle>
- // Title on the "welcome page" of the created HTML documentation.
- // Can be any text.
-
- <CppExtensions></CppExtensions>
- // Overwrites the default. Default is: .hxx .h .hpp
- // Format: File extensions with a dot in front, like ".hcc".
-
- <IdlExtensions></IdlExtensions>
- // Overwrites the default. Default is: .idl
- // Format: File extensions with a dot in front, like ".txt".
-
- <CppDocu html="(on|off) off"/>
-
- <IdlDocu html="(on|off) on"/>
-
-</AutodocConfiguration>
-
-
-
-
-
-
- Historical Command Line Options
- -------------------------------
-
-autodoc.exe
- [ -v <VerboseNr> ]
- -html <OutputDirectory>
- {
- [ -parse ]
- [ -name <RepositoryName> ]
- -lg <ProgrammingLanguage>
- {
- [ -p <ProjectName> <ProjectRootDirectory> ]
- {
- -t <SourceDirectory>*
- -d <SourceDirectory>*
- -f <SourceFile>*
- }+
- }+
- }
-
-Legend:
- <Text>
- command line parameter
- [ ]
- optional
- { }
- Block of connected options.
- The sequence of not connected options does not matter. So the -html or -v options can be used before or after all the parsing options.
- +
- once or more times
- *
- none or more times
-
-
-Explanation of the Options
- -v <VerboseNr> Only for debugging. Bits 1, 2 and 4 in any combination give different output.
- -html <OutputDirectory>
- Gives the directory, where a HTML version of the docu shall be generated.
- -parse Starts the block, where all the parse options are given. This can be omitted, because the parse options are identifiable without it, but it may make a commandline more readable.
- -name <RepositoryName> This name appears as title of the documentation (currently only in the in the C++ version).
- -lg <ProgrammingLanguage>
-
-
- Possible values are:
-
- idl
- This parses all files with the ending .idl .
-
- -p with -t/-d/-f: If there are more than one project, the -p option is required for each one.
-
- The directory given wit the -p option is the root directory of the project.
- If there is no -p option, the working directory is seen as root.
-
- All paths given with -t/-d/-f are relative to that root directory. It is possible to use "." as argument for -t or -d.
-
- Each of -t/-d/-f can have several arguments:
- One could write "-f file1.hxx file2.hxx file_xyz.hxx"
- After each -p (or after -lg, if there is no -p option), there has to be at least one of the following three:
- -t Tree, which means: include subdirectories
- -d Directory, which means: no subdirectories
- -f File", which means: single file name with ending.
- This option also allows to parse some files with an ending different from those, the -lg option implies.
-
-
-