diff options
author | Michael Stahl <mstahl@redhat.com> | 2013-05-03 23:19:14 +0200 |
---|---|---|
committer | Michael Stahl <mstahl@redhat.com> | 2013-06-04 12:01:10 +0200 |
commit | 9d93ed7cd1b36830f6d7aedd4e6f15667774de1d (patch) | |
tree | c8549424e52201982aa4c9926d86361c6655ab30 /odk/docs | |
parent | e2fd9fbe6ec35cf8bd5cd3a5785de2a3c5577265 (diff) |
API CHANGE: odk: stop packaging autodoc tool
There is no need to package doxygen, users can just download that from
upstream.
Change-Id: I166b2f5b692d2335246e3484089ebe5d8edcae4a
Diffstat (limited to 'odk/docs')
-rw-r--r-- | odk/docs/common/ref/idl.css | 164 | ||||
-rw-r--r-- | odk/docs/tools.html | 101 |
2 files changed, 7 insertions, 258 deletions
diff --git a/odk/docs/common/ref/idl.css b/odk/docs/common/ref/idl.css deleted file mode 100644 index 0fde8562ced8..000000000000 --- a/odk/docs/common/ref/idl.css +++ /dev/null @@ -1,164 +0,0 @@ -/* Autodoc css file for IDL documentation */ -/* - * 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 . - */ - -/*See bottom of file for explanations.*/ - -body { background-color:#ffffff; } - -#adc-idlref a { color: #000000; text-decoration: none; } -#adc-idlref a:link { color: #18A303; text-decoration: none; } -#adc-idlref a:hover { text-decoration: underline; } -#adc-idlref a:visited { color: #106802; } - -#adc-idlref h3 - { font-size:13pt; font-weight:bold; - margin-top:3pt; margin-bottom:1pt; } - -#adc-idlref p, #adc-idlref dt, #adc-idlref dd, #adc-idlref pre - { font-size:11pt; - margin-top:3pt; margin-bottom:1pt; } - -#adc-idlref pre { font-family:monospace; } - -#adc-idlref table.subtitle { margin-top:6pt; margin-bottom:6pt; } - -#adc-idlref td { font-size:11pt; } -#adc-idlref td.title - { font-family: Arial; font-size:19pt; font-weight:bold; - line-height:30pt; - background-color:#18a303; - text-align:center; } - -#adc-idlref td.subtitle - { font-family: Arial; font-size:13pt; - line-height:20pt; - background-color:#18a303; } - -#adc-idlref td.crosstitle - { font-size:12pt; font-weight:bold; - line-height:15pt; background-color:#eeeeff; } - -#adc-idlref td.imdetail - { width:100%; - background-color:#c2f6ba; } - -#adc-idlref td.imsum_left { width:30%; } -#adc-idlref td.imsum_right { width:70%; } - -#adc-idlref table.navimain { background-color:#18a303; } - -#adc-idlref td.navimain - { background-color:#18a303; - text-align:center; - font-family: Arial; font-size:12pt; font-weight:bold; - padding-left:7pt; padding-right:7pt; } - -#adc-idlref td.navimainself - { text-align:center; - font-family: Arial; font-size:12pt; font-weight:bold; - color:#ffffff; background-color:#106802;} - -#adc-idlref td.navimainnone - { text-align:center; - font-family: Arial; font-size:12pt; - color:#ffffff; } - -#adc-idlref td.navisub - { text-align:center; - font-family: Arial; font-size:9pt; font-variant:small-caps; - padding-left:7pt; padding-right:7pt; } - -#adc-idlref a.navimain - { text-align:center; - font-family: Arial; font-size:12pt; font-weight:bold; - color:#C44B01; } - -#adc-idlref a.navisub - { text-align:center; - font-family: Arial; font-size:9pt; font-variant:small-caps; - color:#C44B01; } - -#adc-idlref a.membertitle { font-size:12pt; font-weight:bold; line-height:18pt; } - -#adc-idlref a:link.navisub { color:#18a303; } -#adc-idlref a:visited.navisub { color: #106802; } -#adc-idlref a:hover.navisub { color: #106802; text-decoration: underline; } - -#adc-idlref a:link.navimain { color:#ffffff; } -#adc-idlref a:visited.navimain { color: #ffffff; } -#adc-idlref a:hover.navimain { color: #ffffff; text-decoration: underline; } - -#adc-idlref .dt { font-weight:bold; } -#adc-idlref .namechain { font-size:13pt; font-weight:bold; margin-top:3pt; margin-bottom:6pt; } -#adc-idlref .title2 { font-size:13pt; font-style:italic; font-weight:bold; text-align:left; } - -#adc-idlref table { empty-cells:show; } - -#adc-idlref .childlist td, -#adc-idlref .commentedlinks td, -#adc-idlref .memberlist td, -#adc-idlref .subtitle td, -#adc-idlref .crosstitle td { border: .1pt solid grey; } - -#adc-idlref .flag-table td { border: .1pt solid #cccccc; } - -#adc-idlref .title-table td, -#adc-idlref .table-in-method td, -#adc-idlref .table-in-data td, -#adc-idlref .navimain td, -#adc-idlref .navisub td, -#adc-idlref .expl-table td, -#adc-idlref .param-table td { border: none; } - -#adc-idlref .devdoc td { - border-width: 1px; - padding: 5px; - border-style: inset; - border-color: gray; - background-color: white; } - -#adc-idlref .devdoc th { - border-width: 1px; - padding: 5px; - border-style: inset; - border-color: gray; - background-color: white; } - -/* Explanation of CSS classes: - -table.lightbg Background of navigation bar. -.navimain Text in main navigation bar. -.navisub Text in lower navigation bar. -td.navimainself Cell in main navigation bar with "selected" shadow: You are here. -td.navimainnone Cell in main navigation bar with no link. - -.namechain Line with current module path. - -td.crosstitle Comment box for bases (base interfaces etc.) -td.imsum_left Left part of such boxes. -td.imsum_right Right part of such boxes. - -td.title Main title of the page like "interface XYz" -.subtitle Tables, and head cells of those, which list members - like "method summary" and "method details". - -td.imdetail Background table of method's detail description. -a.membertitle Method name (as jump label) in method's detail - description. -*/ diff --git a/odk/docs/tools.html b/odk/docs/tools.html index 219e594dd879..364cb090b25a 100644 --- a/odk/docs/tools.html +++ b/odk/docs/tools.html @@ -128,12 +128,6 @@ in a human readable manner. Special support for type library nodes.</td> </tr> - <tr valign="top"> - <td class="content3"><img src="images/arrow-1.gif"></td> - <td><a href="#autodoc" title="link to the autodoc tool description">autodoc</a></td> - <td class="content87">Tool to generate javadoc-like documentation - for C/C++ and UNOIDL files.</td> - </tr> </table> </td> </tr> @@ -923,94 +917,13 @@ types the specified types depend on.</p> </tr> <tr> <td colspan="3"> - <p>The 'autodoc' tool is used for creating javadoc-like documentation - from C++ and UNOIDL source code.</p> - <p>There are some conventions to follow when documenting C++- or - UNOIDL-sourcecode. See also the <a href="http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/AppendixB/IDL_Documentation_Guidelines" title="link to the UNOIDL Documentation Guidelines">UNOIDL Documentation Guidelines</a>.<br> - If you are not familiar with these, but do know javadoc: For simple C++ - sourcecode documentation, using javadoc-style comments will work.</p> - <p class="head2">Usage:</p> - <blockquote> - <b><code>autodoc [ -v <VerboseNr> ] [ -name "<TitleForTheDocu>" ] -html <OutputDirectory> -lg <SourcecodeLanguage><br> - { [ -p <ProjectName> <ProjectRootDirectory> ] -t <SourceTree>* | -d <SourceDirectory>* | -f <SourceFile>* }*</code></b> - </blockquote> - <p class="head2">Options:</p> - <p> - <table width="100%" border="1" cellpadding="4" cellspacing="0"> - <tr> - <td class="cell15"><code>-v <VerboseNr></code></td> - <td class="cell85"><VerboseNr> == 5 displays the parsed source - code tokens, so you can locate which piece caused an parsing error.<br> - <VerboseNr> == 2 displays not only the parsed source code, - but also the comments.<br><br> - This option must be the first one, if it is used.</td> - </tr> - <tr> - <td class="cell15"><code>-name "<Title>"</code></td> - <td class="cell85"><Title> occurs as the title of the start - page of the HTML output. If this option is omitted, a default title is - created.</td> - </tr> - <tr> - <td class="cell15"><code>-html <OutputDirectory></code></td> - <td class="cell85">specifies the root directory where the HTML output - is created.<br> - Autodoc does not remove old files there, though it overwrites them.</td> - </tr> - <tr> - <td class="cell15"><code>-lg <SourcecodeLanguage></code></td> - <td class="cell85">Possible values are: c++ | idl.<br><br> - This also specifies which files will be parsed: "c++" parses - all files with the endings .hxx and .h, "idl" parses all - files with the ending '.idl' .<br> - To change this behaviour, see at option <code>-f</code>.</td> - </tr> - <tr> - <td class="cell15"><code>-p <ProjectName> <ProjectDirectory></code></td> - <td class="cell85">this option can be used to divide large code - bases into different projects.<br> - <ProjectName> gives a user-defined name for the project.<br> - <ProjectDirectory> is the root to which all paths, given with the - following options <code>-t,-d</code> and <code>-f</code>, are - relative.<br> - This option can be omitted when there are no projects and all paths in - the following options are relative to the working directory.<br><br> - The "{ ... }*" around the options <code>-p,-t,-d,-f</code> - indicates, that this whole block of options can be repeated, each block - starting with a new <code>-p</code>.</td> - </tr> - <tr> - <td class="cell15"><code>-t <SourceTree></code></td> - <td class="cell85">specifies that all files in the directory - <SourceTree> and it's subdirectories are parsed, where the file - ending matches the option <code>-lg</code>.<br> - There can be given multiple directories after one <code>-t</code> - option.<br> - All relative paths are relative to the project-rootdirectory, - given with the <code>-p</code> option.<br> - </td> - </tr> - <tr> - <td class="cell15"><code>-d <SourceDirectory></code></td> - <td class="cell85">Specifies that all files in th directory - <SourceDirectory>, but NOT it's subdirectories, are parsed, where - the file ending matches the option <code>-lg</code>.<br> - There can be multiple directories given after one <code>-d</code> - option.<br> - All relative paths are relative to the project-rootdirectory, - given with the <code>-p</code> option.</td> - </tr> - <tr> - <td class="cell15"><code>-f <SourceFile></code></td> - <td class="cell85">parses the given file. The ending does not have - to match the <code>-lg</code> option.<br> - There can be multiple files given after one <code>-f</code> option.<br> - All relative paths are relative to the project-rootdirectory, - given with the <code>-p</code> option.</td> - </tr> - </table> - </p><b>Remark:</b> The sequence of options matters! Use them in the order given - in the "Usage"-paragraph.</p> + <p>The legacy 'autodoc' tool was used for creating javadoc-like + documentation from C++ and UNO IDL source code in previous versions + of the SDK.</p> + <p>Because this tool was buggy and unmaintained it has been removed + from the SDK. Users are advised to use + <a href="http://www.stack.nl/~dimitri/doxygen/">Doxygen</a> instead, + which supports UNO IDL since April 2013.</p> </td> </tr> </table> |