From 7cbde0f30a6a211023580257a57cdc0836d61943 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mario=20H=C3=BCttel?= Date: Sat, 28 Sep 2019 22:57:31 +0200 Subject: [PATCH] Fixup round for doxygen --- doxygen/external-renderer.dox | 2 +- doxygen/gds-output-renderer.dox | 4 +-- doxygen/latex-renderer.dox | 2 +- doxygen/usage.dox | 36 +++++++++---------- include/gds-render/command-line.h | 12 +++---- include/gds-render/layer/layer-settings.h | 12 ++++--- .../output-renderers/cairo-renderer.h | 2 +- .../output-renderers/latex-renderer.h | 2 +- layer/layer-settings.c | 2 +- output-renderers/cairo-renderer.c | 2 +- output-renderers/latex-renderer.c | 2 +- 11 files changed, 41 insertions(+), 37 deletions(-) diff --git a/doxygen/external-renderer.dox b/doxygen/external-renderer.dox index e7bbad5..2211729 100644 --- a/doxygen/external-renderer.dox +++ b/doxygen/external-renderer.dox @@ -2,7 +2,7 @@ * @defgroup ExternalRenderer External Shared Object Renderer * @ingroup GdsOutputRenderer * - * @subsection ExternalRendererProps Properties + * @section ExternalRendererProps Properties * This class inherits all properties from its parent @ref GdsOutputRenderer. * In addition to that, it implements the following properties: * diff --git a/doxygen/gds-output-renderer.dox b/doxygen/gds-output-renderer.dox index 6d2e083..a5382d4 100644 --- a/doxygen/gds-output-renderer.dox +++ b/doxygen/gds-output-renderer.dox @@ -15,7 +15,7 @@ * * By default this class implements the following features: * - * @subsection GdsOutputRendererProps Properties + * @section GdsOutputRendererProps Properties * Property Name | Description * -----------------|---------------------------------------------------------------- * layer-settings | LayerSettings object containing the layer rendering information @@ -23,7 +23,7 @@ * * All these properties have to be set for rendering. * - * @subsection GdsOutputRendererSignals Signals / Events + * @section GdsOutputRendererSignals Signals / Events * Signal Name | Description | Callback prototype * -----------------|-------------------------------------------------|----------------------------------------------------------- * async-finished | The asynchronous rendering is finished | void callback(GdsOutputRenderer *src, gpointer user_data) diff --git a/doxygen/latex-renderer.dox b/doxygen/latex-renderer.dox index 3f4e2b2..75dc1d4 100644 --- a/doxygen/latex-renderer.dox +++ b/doxygen/latex-renderer.dox @@ -4,7 +4,7 @@ * * This is the class implementing the \f$\mbox{\LaTeX}\f$ / TikZ output rendering - * @subsection LaTeXRendererProps Properties + * @section LaTeXRendererProps Properties * This class inherits all properties from its parent @ref GdsOutputRenderer. * In addition to that, it implements the following properties: * diff --git a/doxygen/usage.dox b/doxygen/usage.dox index 940204d..98d1a32 100644 --- a/doxygen/usage.dox +++ b/doxygen/usage.dox @@ -4,24 +4,24 @@ To use the application on the command line check 'gds-render `--`help'. Usage: - gds-render [OPTION…] FILE - Convert GDS file to graphic + gds-render [OPTION…] FILE - Convert GDS file `` to graphic -Help Options: - -h, '--'help Show help options - '--'help-all Show all help options - '--'help-gtk Show GTK+ Options - -Application Options: - -v, '--'version Print version - -r, '--'renderer=pdf|svg|tikz|ext Renderer to use - -s, '--'scale= Divide output coordinates by - -o, '--'output-file=PATH Output file path - -m, '--'mapping=PATH Path for Layer Mapping File - -c, '--'cell=NAME Cell to render - -a, '--'tex-standalone Create standalone PDF - -l, '--'tex-layers Create PDF Layers (OCG) - -P, '--'custom-render-lib=PATH Path to a custom shared object, that implements the render_cell_to_file function - '--'display=DISPLAY X display to use +Help Options: + -h, `--`help Show help options + `--`help-all Show all help options + `--`help-gtk Show GTK+ Options + +Application Options: + -v, `--`version Print version + -r, `--`renderer=pdf|svg|tikz|ext Renderer to use + -s, `--`scale=`` Divide output coordinates by `` + -o, `--`output-file=PATH Output file path + -m, `--`mapping=PATH Path for Layer Mapping File + -c, `--`cell=NAME Cell to render + -a, `--`tex-standalone Create standalone PDF + -l, `--`tex-layers Create PDF Layers (OCG) + -P, `--`custom-render-lib=PATH Path to a custom shared object, that implements the render_cell_to_file function + `--`display=DISPLAY X display to use @section gui Graphical User Interface @@ -33,7 +33,7 @@ It is possible to export the layer configurations so they can be used later on. @image html gui.png @image latex gui.png -The cell selector on the left shows the GDS Libraries and Cells. The cells are marked green if all references inside the cell could be found. If not all references could be found, the cell is marked orange. This doens't show if child cells have missing childs. Only one level of the hierarchy is checked in order to make it easier to spot an errorneous cell. Cells with missing child cells are still renderable but '--' obviously '--' faulty. If a cell or any sub-cell contains a reference loop, the cell is marked red. In this case it can't be selected for rendering. +The cell selector on the left shows the GDS Libraries and Cells. The cells are marked green if all references inside the cell could be found. If not all references could be found, the cell is marked orange. This doens't show if child cells have missing childs. Only one level of the hierarchy is checked in order to make it easier to spot an errorneous cell. Cells with missing child cells are still renderable but `--` obviously `--` faulty. If a cell or any sub-cell contains a reference loop, the cell is marked red. In this case it can't be selected for rendering. In the above image the cell is green; so everything is okay. diff --git a/include/gds-render/command-line.h b/include/gds-render/command-line.h index 2285143..fc1871e 100644 --- a/include/gds-render/command-line.h +++ b/include/gds-render/command-line.h @@ -42,16 +42,16 @@ * @param layer_file Layer mapping file * @param so_path Shared object * @param tex_standalone Standalone TeX - * @param tec_layers TeX OCR layers + * @param tex_layers TeX OCR layers * @param scale Scale value * @return Error code, 0 if successful */ int command_line_convert_gds(const char *gds_name, - const char *cell_name, - char **renderers, - char **output_file_names, - const char *layer_file, - const char *so_path, + const char *cell_name, + char **renderers, + char **output_file_names, + const char *layer_file, + const char *so_path, gboolean tex_standalone, gboolean tex_layers, double scale); diff --git a/include/gds-render/layer/layer-settings.h b/include/gds-render/layer/layer-settings.h index f8ce1a7..6008e1d 100644 --- a/include/gds-render/layer/layer-settings.h +++ b/include/gds-render/layer/layer-settings.h @@ -18,8 +18,8 @@ */ /** - * @file layer-info.h - * @brief LayerSettings class heade file + * @file layer-settings.h + * @brief LayerSettings class header file * @author Mario Hüttel */ @@ -96,8 +96,12 @@ int layer_settings_remove_layer(LayerSettings *settings, int layer); GList *layer_settings_get_layer_info_list(LayerSettings *settings); /** - * @brief Write layer settings to a CSV file - * @param path + * @brief Write layer settings to a CSV file. + * + * This function writes the layer settings to a CSV file according to the + * layer mapping specification (@ref lmf-spec) + * @param settings LayerSettings object + * @param path Output path for CSV file. * @return 0 if successful */ int layer_settings_to_csv(LayerSettings *settings, const char *path); diff --git a/include/gds-render/output-renderers/cairo-renderer.h b/include/gds-render/output-renderers/cairo-renderer.h index 8f2abc9..cceb692 100644 --- a/include/gds-render/output-renderers/cairo-renderer.h +++ b/include/gds-render/output-renderers/cairo-renderer.h @@ -17,7 +17,7 @@ * along with GDSII-Converter. If not, see . */ /** - * @file cairo-output.h + * @file cairo-renderer.h * @brief Header File for Cairo output renderer * @author Mario Hüttel */ diff --git a/include/gds-render/output-renderers/latex-renderer.h b/include/gds-render/output-renderers/latex-renderer.h index 4c58f16..8c374e9 100644 --- a/include/gds-render/output-renderers/latex-renderer.h +++ b/include/gds-render/output-renderers/latex-renderer.h @@ -18,7 +18,7 @@ */ /** - * @file latex-output.h + * @file latex-renderer.h * @brief LaTeX output renderer * @author Mario Hüttel */ diff --git a/layer/layer-settings.c b/layer/layer-settings.c index 330cde8..c1c3167 100644 --- a/layer/layer-settings.c +++ b/layer/layer-settings.c @@ -18,7 +18,7 @@ */ /** - * @file layer-info.c + * @file layer-settings.c * @brief Implementation of the LayerSettings class * @author Mario Hüttel */ diff --git a/output-renderers/cairo-renderer.c b/output-renderers/cairo-renderer.c index 572e1f4..7ee76d9 100644 --- a/output-renderers/cairo-renderer.c +++ b/output-renderers/cairo-renderer.c @@ -17,7 +17,7 @@ * along with GDSII-Converter. If not, see . */ /** - * @file cairo-output.c + * @file cairo-renderer.c * @brief Output renderer for Cairo PDF export * @author Mario Hüttel */ diff --git a/output-renderers/latex-renderer.c b/output-renderers/latex-renderer.c index f7f9b97..654a2fb 100644 --- a/output-renderers/latex-renderer.c +++ b/output-renderers/latex-renderer.c @@ -18,7 +18,7 @@ */ /** - * @file latex-output.c + * @file latex-renderer.c * @brief LaTeX Output Renderer * @author Mario Hüttel */