diff options
Diffstat (limited to 'autodoc/source/exes/adc_uni/spec-CommandLine.txt')
-rw-r--r-- | autodoc/source/exes/adc_uni/spec-CommandLine.txt | 197 |
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. - - - |