diff options
38 files changed, 1284 insertions, 827 deletions
diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml index 3f84030..22edb06 100644 --- a/.gitlab-ci.yml +++ b/.gitlab-ci.yml @@ -12,8 +12,12 @@ autotools-build: script: - ./autogen.sh --prefix=/usr - make + - make dist except: - tags + artifacts: + paths: + - gtk-doc-*.tar.* autotools-test: stage: test @@ -33,11 +37,35 @@ autotools-test: meson-build: stage: build script: + - find . -name .git -prune -o -print | LC_ALL=C sort -u > git-filelist.txt - meson --prefix /usr _build . - ninja -C _build - meson test -C _build except: - tags + artifacts: + when: always + paths: + - _build/meson-logs/* + - git-filelist.txt + +meson-from-tarball: + stage: test + dependencies: + - autotools-build + variables: + GIT_STRATEGY: none + script: + - tar -xvf gtk-doc-*.tar.* + - ( cd gtk-doc-*/; find . -name .git -prune -o -print ) | LC_ALL=C sort -u > tar-filelist.txt + - ( cd gtk-doc-*/; meson --prefix /usr ../_build . ) + - ninja -C _build + - meson test -C _build + artifacts: + when: on_failure + paths: + - _build/meson-logs/*.log + - tar-filelist.txt # common diff --git a/Makefile.am b/Makefile.am index d7c7dbb..c383e85 100644 --- a/Makefile.am +++ b/Makefile.am @@ -57,9 +57,13 @@ EXTRA_DIST = \ MAINTAINERS \ $(gtkdocdata_DATA) \ $(pylibdata_DATA) \ + autogen.sh \ gtk-doc.pc.in \ gtk-doc.doap \ gtk-doc-fo.xsl \ + meson.build \ + meson_options.txt \ + requirements.txt \ doc/README \ doc/authors.txt \ doc/gnome.txt \ @@ -68,6 +72,12 @@ EXTRA_DIST = \ doc/style-guide.txt \ examples/README \ examples/Makefile.am \ + gtkdoc/meson.build \ + gtkdoc_uninstalled.py.in \ + style/COPYING \ + style/meson.build \ + tools/c10e-html.py \ + tools/db2md.py \ tools/docpercentages.pl \ tools/gtk-doc.el \ COPYING-DOCS @@ -1,3 +1,22 @@ +GTK-Doc 1.33.1 (Nov 17 2020) +=============== + +Build GObject scanner with asan +Ignore deprecations in the GObject scanner +autotools: Fix distclean support +meson: Use lib/cmake +Translation updates + +GTK-Doc 1.33.0 (Oct 1 2020) +============= + +Support documenting GTK actions +Recognize GDK_DECLARE_ macros +Better table styling in html output +Use plain C types for basic types +Make builds more reproducible +Translation updates + GTK-Doc 1.32.1 (Aug 15 2019) =============== diff --git a/buildsystems/autotools/Makefile.am b/buildsystems/autotools/Makefile.am index dde0d11..705451e 100644 --- a/buildsystems/autotools/Makefile.am +++ b/buildsystems/autotools/Makefile.am @@ -1,6 +1,7 @@ EXTRA_DIST = \ $(autotoolsdata_DATA) \ - gtk-doc.m4 + gtk-doc.m4 \ + meson.build CLEANFILES = gtk-doc.flat.make gtk-doc.no-xslt-flat.make diff --git a/buildsystems/autotools/gtk-doc.make b/buildsystems/autotools/gtk-doc.make index 7d9a27f..c673175 100644 --- a/buildsystems/autotools/gtk-doc.make +++ b/buildsystems/autotools/gtk-doc.make @@ -57,6 +57,7 @@ DOC_STAMPS=setup-build.stamp scan-build.stamp sgml-build.stamp \ sgml.stamp html.stamp pdf.stamp SCANOBJ_FILES = \ + $(DOC_MODULE).actions \ $(DOC_MODULE).args \ $(DOC_MODULE).hierarchy \ $(DOC_MODULE).interfaces \ diff --git a/buildsystems/autotools/gtk-doc.no-xslt.make b/buildsystems/autotools/gtk-doc.no-xslt.make index 26a98bd..1acee5e 100644 --- a/buildsystems/autotools/gtk-doc.no-xslt.make +++ b/buildsystems/autotools/gtk-doc.no-xslt.make @@ -57,6 +57,7 @@ DOC_STAMPS=setup-build.stamp scan-build.stamp sgml-build.stamp \ sgml.stamp html.stamp pdf.stamp SCANOBJ_FILES = \ + $(DOC_MODULE).actions \ $(DOC_MODULE).args \ $(DOC_MODULE).hierarchy \ $(DOC_MODULE).interfaces \ diff --git a/buildsystems/cmake/Makefile.am b/buildsystems/cmake/Makefile.am index a11e89b..5d5b7cb 100644 --- a/buildsystems/cmake/Makefile.am +++ b/buildsystems/cmake/Makefile.am @@ -1,7 +1,8 @@ EXTRA_DIST = \ GtkDocConfig.cmake \ GtkDocConfigVersion.cmake.in \ - GtkDocScanGObjWrapper.cmake + GtkDocScanGObjWrapper.cmake \ + meson.build CLEANFILES = \ GtkDocConfigVersion.cmake diff --git a/configure.ac b/configure.ac index f242c80..155218a 100644 --- a/configure.ac +++ b/configure.ac @@ -3,7 +3,7 @@ AC_PREREQ([2.63]) dnl We're using a two digit number for the releases and dnl a three digit number for the development version -m4_define(gtk_doc_version, 1.32.1) +m4_define(gtk_doc_version, 1.33.1) AC_INIT([gtk-doc],[gtk_doc_version],[https://gitlab.gnome.org/GNOME/gtk-doc/issues],[gtk-doc]) diff --git a/gtk-doc.xsl b/gtk-doc.xsl index 1a7a1ee..7d6530b 100644 --- a/gtk-doc.xsl +++ b/gtk-doc.xsl @@ -41,6 +41,7 @@ <xsl:param name="html.ext" select="'.html'"/> <xsl:param name="refentry.generate.name" select="0"/> <xsl:param name="refentry.generate.title" select="1"/> + <xsl:param name="abstract.notitle.enabled" select="1"/> <!-- don't generate all those link tags (very slow and hardly used) it does not show much effect as we have a user.head.content template <xsl:param name="html.extra.head.links" select="0" /> @@ -399,6 +400,7 @@ Get a newer version at http://docbook.sourceforge.net/projects/xsl/ <xsl:variable name="sect_derived_interfaces" select="./refsect1[@role='derived_interfaces']"/> <xsl:variable name="sect_implementations" select="./refsect1[@role='implementations']"/> <xsl:variable name="sect_properties" select="./refsect1[@role='properties']"/> + <xsl:variable name="sect_actions" select="./refsect1[@role='actions']"/> <xsl:variable name="sect_child_properties" select="./refsect1[@role='child_properties']"/> <xsl:variable name="sect_style_properties" select="./refsect1[@role='style_properties']"/> <xsl:variable name="sect_signal_proto" select="./refsect1[@role='signal_proto']"/> @@ -481,6 +483,12 @@ Get a newer version at http://docbook.sourceforge.net/projects/xsl/ <xsl:value-of select="./refsect1[@role='signal_proto']/title"/> </a></span> </xsl:if> + <xsl:if test="count($sect_actions) > 0"> + <span id="nav_properties">  <span class="dim">|</span>  + <a href="#{$section_id}.actions" class="shortcut"> + <xsl:value-of select="./refsect1[@role='actions']/title"/> + </a></span> + </xsl:if> </xsl:when> <!-- this is not yet very nice, as it requires all glossdic/indexdiv elements having a anchor element. maybe we can customize the xsl diff --git a/gtkdoc/mkdb.py b/gtkdoc/mkdb.py index 87fdf24..98fd5eb 100644 --- a/gtkdoc/mkdb.py +++ b/gtkdoc/mkdb.py @@ -57,6 +57,11 @@ ArgBlurbs = [] # Docstring of the Arg. ArgDefaults = [] # Default value of the Arg. ArgRanges = [] # The range of the Arg type +ActionObjects = [] +ActionNames = [] +ActionParams = [] +ActionProperties = [] + # These global hashes store declaration info keyed on a symbol name. Declarations = {} DeclarationTypes = {} @@ -150,10 +155,10 @@ AnnotationDefinition = { 'scope notified': "The callback is valid until the GDestroyNotify argument is called.", 'set-value-func': "The specified function is used to convert from a struct to a GValue, must be a GTypeInstance.", 'skip': "Exposed in C code, not necessarily available in other languages.", - 'transfer container': "Free data container after the code is done.", + 'transfer container': "The caller owns the data container, but not the data inside it.", 'transfer floating': "Alias for <acronym>transfer none</acronym>, used for objects with floating refs.", - 'transfer full': "Free data after the code is done.", - 'transfer none': "Don't free data after the code is done.", + 'transfer full': "The caller owns the data, and is responsible for free it.", + 'transfer none': "The data is owned by the callee, which is responsible of freeing it.", 'type': "Override the parsed C type with given type.", 'unref-func': "The specified function is used to unref a struct, must be a GTypeInstance.", 'virtual': "This is the invoker for a virtual method.", @@ -207,7 +212,7 @@ DB_REFENTRY = string.Template('''${header} <refpurpose>${short_desc}</refpurpose> </refnamediv> ${stability} -${functions_synop}${args_synop}${signals_synop}${object_anchors}${other_synop}${hierarchy}${prerequisites}${derived}${interfaces}${implementations} +${functions_synop}${args_synop}${signals_synop}${actions_synop}${object_anchors}${other_synop}${hierarchy}${prerequisites}${derived}${interfaces}${implementations} ${include_output} <refsect1 id="${section_id}.description" role="desc"> <title role="desc.title">Description</title> @@ -217,7 +222,7 @@ ${extralinks}${long_desc} <title role="details.title">Functions</title> ${functions_details} </refsect1> -${other_desc}${args_desc}${signals_desc}${see_also} +${other_desc}${args_desc}${signals_desc}${actions_desc}${see_also} </refentry> ''') @@ -285,6 +290,7 @@ def Run(options): ReadKnownSymbols(os.path.join(ROOT_DIR, MODULE + "-sections.txt")) ReadSignalsFile(os.path.join(ROOT_DIR, MODULE + ".signals")) ReadArgsFile(os.path.join(ROOT_DIR, MODULE + ".args")) + ReadActionsFile(os.path.join(ROOT_DIR, MODULE + ".actions")) obj_tree = ReadObjectHierarchy(os.path.join(ROOT_DIR, MODULE + ".hierarchy")) ReadInterfaces(os.path.join(ROOT_DIR, MODULE + ".interfaces")) ReadPrerequisites(os.path.join(ROOT_DIR, MODULE + ".prerequisites")) @@ -513,6 +519,8 @@ def OutputDB(file, options): args_desc = '' child_args_desc = '' style_args_desc = '' + actions_synop = '' + actions_desc = '' hierarchy_str = '' hierarchy = [] interfaces = '' @@ -627,6 +635,30 @@ def OutputDB(file, options): args_desc += make_refsect1_desc(style_args_desc, 'Style Property Details', section_id, 'style-property-details') + actions_synop = re.sub(r'^\n*', '', actions_synop) + actions_synop = re.sub(r'\n+$', '\n', actions_synop) + if actions_synop != '': + actions_synop = '''<refsect1 id="%s.actions" role="actions"> +<title role="actions.title">Actions</title> +<informaltable frame="none"> +<tgroup cols="3"> +<colspec colname="actions_none" colwidth="150px"/> +<colspec colname="actions_name" colwidth="300px"/> +<colspec colname="actions_param" colwidth="200px"/> +<tbody> +%s +</tbody> +</tgroup> +</informaltable> +</refsect1> +''' % (section_id, actions_synop) + actions_desc = trim_leading_and_trailing_nl(actions_desc) + actions_desc = '''<refsect1 id="%s.action-details" role="action_details"> +<title role="action_details.title">Action Details</title> +%s +</refsect1> +''' % (section_id, actions_desc) + hierarchy_str = AddTreeLineArt(hierarchy) if hierarchy_str != '': hierarchy_str = make_refsect1_desc('<screen>' + hierarchy_str + '\n</screen>', @@ -657,6 +689,7 @@ def OutputDB(file, options): functions_details, other_desc, signals_synop, signals_desc, args_synop, args_desc, + actions_synop, actions_desc, hierarchy_str, interfaces, implementations, prerequisites, derived, @@ -683,6 +716,8 @@ def OutputDB(file, options): args_desc = '' child_args_desc = '' style_args_desc = '' + actions_synop = '' + actions_desc = '' hierarchy_str = '' hierarchy = [] interfaces = '' @@ -721,6 +756,7 @@ def OutputDB(file, options): sig_synop, sig_desc = GetSignals(symbol) arg_synop, child_arg_synop, style_arg_synop, arg_desc, child_arg_desc, style_arg_desc = GetArgs( symbol) + action_synop, action_desc = GetActions(symbol) ifaces = GetInterfaces(symbol) impls = GetImplementations(symbol) prereqs = GetPrerequisites(symbol) @@ -735,6 +771,8 @@ def OutputDB(file, options): args_desc += arg_desc child_args_desc += child_arg_desc style_args_desc += style_arg_desc + actions_synop += action_synop + actions_desc += action_desc interfaces += ifaces implementations += impls prerequisites += prereqs @@ -905,6 +943,7 @@ def OutputIndex(basename, apiindex): logging.info("trying symbol %s", symbol) m1 = re.search(r'(.*)::(.*)', symbol) m2 = re.search(r'(.*):(.*)', symbol) + m3 = re.search(r'(.*)\|(.*)', symbol) if m1: oname = m1.group(1) osym = m1.group(2) @@ -929,6 +968,18 @@ def OutputIndex(basename, apiindex): symbol_section = SymbolSection[oname] symbol_section_id = SymbolSectionId[oname] break + elif m3: + oname = m3.group(1) + osym = m3.group(2) + logging.info(" trying action %s|%s in %d actions", oname, osym, len(ActionNames)) + for name in ActionNames: + logging.info(" " + name) + if name == osym: + symbol_type = "action" + if oname in SymbolSection: + symbol_section = SymbolSection[oname] + symbol_section_id = SymbolSectionId[oname] + break else: if symbol in SymbolSection: symbol_section = SymbolSection[symbol] @@ -1123,6 +1174,7 @@ def OutputDeclaration(symbol, declaration): """ dtype = DeclarationTypes[symbol] + logging.info('Output Symbol: "%s" "%s"', symbol, dtype) if dtype == 'MACRO': return OutputMacro(symbol, declaration) elif dtype == 'TYPEDEF': @@ -2051,7 +2103,7 @@ def ParseStabilityLevel(stability, file, line, message): return str(stability) -def OutputDBFile(file, title, section_id, includes, functions_synop, other_synop, functions_details, other_desc, signals_synop, signals_desc, args_synop, args_desc, hierarchy, interfaces, implementations, prerequisites, derived, file_objects, default_stability): +def OutputDBFile(file, title, section_id, includes, functions_synop, other_synop, functions_details, other_desc, signals_synop, signals_desc, args_synop, args_desc, actions_synop, actions_desc, hierarchy, interfaces, implementations, prerequisites, derived, file_objects, default_stability): """Outputs the final DocBook file for one section. Args: @@ -2068,6 +2120,8 @@ def OutputDBFile(file, title, section_id, includes, functions_synop, other_synop signal_desc (str): the DocBook for the Signal Description part args_synop (str): the DocBook for the Arg Synopsis part args_desc (str): the DocBook for the Arg Description part + actions_synop (str): the DocBook for the Action Synopsis part + actions_desc (str): the DocBook for the Action Description part hierarchy (str): the DocBook for the Object Hierarchy part interfaces (str): the DocBook for the Interfaces part implementations (str): the DocBook for the Known Implementations part @@ -2187,6 +2241,8 @@ def OutputDBFile(file, title, section_id, includes, functions_synop, other_synop # "<refentry id="$section_id" revision="$mday $month $year">" OUTPUT.write(DB_REFENTRY.substitute({ + 'actions_desc': actions_desc, + 'actions_synop': actions_synop, 'args_desc': args_desc, 'args_synop': args_synop, 'derived': derived, @@ -3601,6 +3657,72 @@ def GetArgs(gobject): return (synop, child_synop, style_synop, desc, child_desc, style_desc) +def GetActions(gobject): + """Generate action docs. + + Returns the synopsis and detailed description DocBook output + for the actions of a given GtkWidget subclass. + + Args: + object (str): the GObject subclass, e.g. 'GtkButton'. + + Returns: + str: action docs + """ + synop = '' + desc = '' + + for i in range(len(ActionObjects)): + if ActionObjects[i] == gobject: + logging.info("Found action: %s", ActionNames[i]) + name = ActionNames[i] + params = ActionParams[i] + prop = ActionProperties[i] + + # Remember: pipe, so we don't clash with signals. + symbol = '%s|%s' % (gobject, name) + sid = common.CreateValidSGMLID(symbol) + + AllSymbols[symbol] = 1 + blurb = '' + if symbol in SymbolDocs and not IsEmptyDoc(SymbolDocs[symbol]): + blurb = ConvertMarkDown(symbol, SymbolDocs[symbol]) + logging.info(".. [%s][%s]", SymbolDocs[symbol], blurb) + AllDocumentedSymbols[symbol] = 1 + + else: + # FIXME: print a warning? + logging.info(".. no description") + + pad1 = '' + if len(name) < 24: + pad1 = " " * (24 - len(name)) + + action_synop = "<row><entry></entry><entry role=\"action_name\"><link linkend=\"%s\">%s</link></entry><entry role=\"parameter_type\">%s</entry></row>\n" % ( + sid, name, params) + action_desc = u"<refsect2 id=\"%s\" role=\"action\"><title>The <literal>“%s”</literal> action</title>\n" % ( + sid, name) + action_desc += MakeIndexterms(symbol, sid) + action_desc += "\n" + action_desc += OutputSymbolExtraLinks(symbol) + if blurb != '': + action_desc += blurb + elif prop != '': + action_desc += "<para>The %s action sets the %s property.</para>\n" % (name, MakeHashXRef (gobject + ':' + prop, "type")) + action_desc += MakeDeprecationNote(symbol) + + if params != '': + action_desc += "<para>Parameter type: %s</para>\n" % params + + action_desc += OutputParamDescriptions("ACTION", symbol, None) + action_desc += OutputSymbolTraits(symbol) + action_desc += "</refsect2>\n" + + synop += action_synop + desc += action_desc + + return (synop, desc) + def IgnorePath(path, source_dirs, ignore_files): for sdir in source_dirs: # Cut off base directory @@ -3763,9 +3885,18 @@ def SegmentCommentBlock(lines, line_number=0, ifile=''): logging.info("scanning[%s] :%s", in_part, line.strip()) # If we haven't found the symbol name yet, look for it. + # We need to allow for the following cases: + # function: + # Class::signal: + # Class:property: + # Class|action: + # Signal and property names can contain dashes, action names + # can contain period. + # In all cases, there might be annotations in parentheses + # following the symbol name. if not symbol: m1 = re.search(r'^\s*((SECTION|PROGRAM):\s*\S+)', line) - m2 = re.search(r'^\s*([\w:-]*\w)\s*:?\s*(\(.+?\)\s*)*$', line) + m2 = re.search(r'^\s*([\w:.|-]*\w)\s*:?\s*(\(.+?\)\s*)*$', line) if m1: symbol = m1.group(1) logging.info("docs found in source for : '%s'", symbol) @@ -4664,6 +4795,70 @@ def ReadArgsFile(ifile): INPUT.close() +def ReadActionsFile(ifile): + """Reads information about object actions + + It creates the arrays ActionObjects, ActionNames, ActionParams + and ActionProperties containing info on the actions. + + Args: + ifile (str): the input filename. + """ + in_action = False + action_object = None + action_name = None + action_param = None + action_prop = None + + # Reset the args info. + ActionObjects[:] = [] + ActionNames[:] = [] + ActionParams[:] = [] + ActionProperties[:] = [] + + if not os.path.isfile(ifile): + return + + INPUT = open(ifile, 'r', encoding='utf-8') + line_number = 0 + for line in INPUT: + line_number += 1 + if not in_action: + if line.startswith('<ACTION>'): + in_action = True + action_object = '' + action_name = '' + action_param = '' + action_prop = '' + + else: + m1 = re.search(r'^<NAME>(.*)</NAME>', line) + m2 = re.search(r'^<PARAMETER>(.*)</PARAMETER>', line) + m3 = re.search(r'^<PROPERTY>(.*)</PROPERTY>', line) + if m1: + action_name = m1.group(1) + m1_1 = re.search(r'^(.*):::(.*)$', action_name) + if m1_1: + action_object = m1_1.group(1) + action_name = m1_1.group(2).replace('_', '-') + logging.info("Found action: %s", action_name) + else: + common.LogWarning(ifile, line_number, "Invalid action name: " + action_name) + + elif m2: + action_param = m2.group(1) + elif m3: + action_prop = m3.group(1) + elif re.search(r'^</ACTION>', line): + logging.info("Found end of action: %s::%s", action_object, action_name) + ActionObjects.append(action_object) + ActionNames.append(action_name) + ActionParams.append(action_param) + ActionProperties.append(action_prop) + in_action = False + + INPUT.close() + def AddTreeLineArt(tree): """Generate a line art tree. diff --git a/gtkdoc/mkhtml2.py b/gtkdoc/mkhtml2.py index 093deb3..1336da9 100644 --- a/gtkdoc/mkhtml2.py +++ b/gtkdoc/mkhtml2.py @@ -1912,7 +1912,7 @@ def run(options): module = options.args[0] document = options.args[1] - output_dir = options.output_dir or os.getcmd() + output_dir = options.output_dir or os.getcwd() if options.output_dir and not os.path.isdir(output_dir): os.mkdir(output_dir) diff --git a/gtkdoc/scan.py b/gtkdoc/scan.py index 6c6534a..4b5b8a9 100644 --- a/gtkdoc/scan.py +++ b/gtkdoc/scan.py @@ -111,8 +111,8 @@ CLINE_MATCHER = [ \s*\=""" % VAR_TYPE_MODIFIER, re.VERBOSE), # 17: G_DECLARE_* re.compile( - r""".*G_DECLARE_ - (FINAL_TYPE|DERIVABLE_TYPE|INTERFACE) # 1: variant + r""".*(G_DECLARE_|GDK_DECLARE_) + (FINAL_TYPE|DERIVABLE_TYPE|INTERNAL_TYPE|INTERFACE) # 1: variant \s*\(""", re.VERBOSE), # 18-21: FUNCTIONS None, # in InitScanner() @@ -733,7 +733,7 @@ def ScanHeaderContent(input_lines, decl_list, get_types, options): elif cm[17]: in_declaration = 'g-declare' - symbol = 'G_DECLARE_' + cm[17].group(1) + symbol = cm[17].group(1) + cm[17].group(2) decl = line[cm[17].end():] # FUNCTIONS diff --git a/gtkdoc/scangobj.py b/gtkdoc/scangobj.py index 7434ec1..0156734 100644 --- a/gtkdoc/scangobj.py +++ b/gtkdoc/scangobj.py @@ -40,6 +40,12 @@ COMMON_INCLUDES = """ #include <stdio.h> #include <errno.h> #include <glib-object.h> + +#ifndef G_GNUC_BEGIN_IGNORE_DEPRECATIONS +# define G_GNUC_BEGIN_IGNORE_DEPRECATIONS +# define G_GNUC_END_IGNORE_DEPRECATIONS +#endif + """ QUERY_CHILD_PROPS_PROTOTYPE = "extern GParamSpec** %s (gpointer class, guint *n_properties);" @@ -67,6 +73,8 @@ get_object_types (void) gpointer g_object_class; gint i = 0; +G_GNUC_BEGIN_IGNORE_DEPRECATIONS + ${get_types} object_types[i] = G_TYPE_INVALID; @@ -86,6 +94,8 @@ ${get_types} g_type_class_unref (g_object_class); +G_GNUC_END_IGNORE_DEPRECATIONS + return object_types; } @@ -100,6 +110,7 @@ const gchar *hierarchy_filename = "${new_hierarchy_filename}"; const gchar *interfaces_filename = "${new_interfaces_filename}"; const gchar *prerequisites_filename = "${new_prerequisites_filename}"; const gchar *args_filename = "${new_args_filename}"; +const gchar *actions_filename = "${new_actions_filename}"; static void output_signals (void); static void output_object_signals (FILE *fp, @@ -125,6 +136,9 @@ static void output_prerequisites (FILE *fp, static void output_args (void); static void output_object_args (FILE *fp, GType object_type); +static void output_actions (void); +static void output_object_actions (FILE *fp, GType object_type); + int main (${main_func_params}) { @@ -137,6 +151,7 @@ main (${main_func_params}) output_object_interfaces (); output_interface_prerequisites (); output_args (); + output_actions (); return 0; } @@ -182,7 +197,8 @@ output_object_signals (FILE *fp, GType object_type) object_class_name = g_type_name (object_type); signals = g_signal_list_ids (object_type, &n_signals); - qsort (signals, n_signals, sizeof (guint), compare_signals); + if (n_signals > 0) + qsort (signals, n_signals, sizeof (guint), compare_signals); for (sig = 0; sig < n_signals; sig++) { output_object_signal (fp, object_class_name, signals[sig]); @@ -333,29 +349,37 @@ get_type_name (GType type, gboolean * is_pointer) switch (type) { case G_TYPE_NONE: - case G_TYPE_CHAR: case G_TYPE_UCHAR: case G_TYPE_BOOLEAN: - case G_TYPE_INT: case G_TYPE_UINT: case G_TYPE_LONG: case G_TYPE_ULONG: - case G_TYPE_FLOAT: - case G_TYPE_DOUBLE: case G_TYPE_POINTER: /* These all have normal C type names so they are OK. */ return type_name; + case G_TYPE_CHAR: + return "char"; + + case G_TYPE_INT: + return "int"; + + case G_TYPE_FLOAT: + return "float"; + + case G_TYPE_DOUBLE: + return "double"; + case G_TYPE_STRING: /* A GtkString is really a gchar*. */ *is_pointer = TRUE; - return "gchar"; + return "char"; case G_TYPE_ENUM: case G_TYPE_FLAGS: /* We use a gint for both of these. Hopefully a subtype with a decent name will be registered and used instead, as GTK+ does itself. */ - return "gint"; + return "int"; case G_TYPE_BOXED: /* The boxed type shouldn't be used itself, only subtypes. Though we @@ -565,6 +589,71 @@ output_prerequisites (FILE *fp, } static void +output_actions (void) +{ + FILE *fp; + gint i; + + fp = fopen (actions_filename, "w"); + if (fp == NULL) { + g_warning ("Couldn't open output file: %s : %s", actions_filename, g_strerror(errno)); + return; + } + + for (i = 0; object_types[i]; i++) { + output_object_actions (fp, object_types[i]); + } + + fclose (fp); +} + +static void +output_object_actions (FILE *fp, GType object_type) +{ + gpointer class; + + if (!G_TYPE_IS_OBJECT (object_type)) + return; + + class = g_type_class_peek (object_type); + if (!class) + return; + +#ifdef GTK_IS_WIDGET_CLASS +#if GTK_CHECK_VERSION(3,96,0) + if (GTK_IS_WIDGET_CLASS (class)) { + guint i = 0; + const char *action_name; + GType owner; + const GVariantType *parameter_type; + const char *property_name; + const gchar *object_class_name; + + object_class_name = g_type_name (object_type); + while (gtk_widget_class_query_action (GTK_WIDGET_CLASS (class), + i, + &owner, + &action_name, + ¶meter_type, + &property_name)) { + i++; + if (owner == G_TYPE_FROM_CLASS (class)) + fprintf (fp, "<ACTION>\\n" + "<NAME>%s:::%s</NAME>\\n" + "<PARAMETER>%s</PARAMETER>\\n" + "<PROPERTY>%s</PROPERTY>\\n" + "</ACTION>\\n\\n", + object_class_name, + action_name, + parameter_type ? g_variant_type_peek_string (parameter_type) : "", + property_name ? property_name : ""); + } + } +#endif +#endif +} + +static void output_args (void) { FILE *fp; @@ -1095,7 +1184,8 @@ output_object_args (FILE *fp, GType object_type) style_prop = FALSE; while (TRUE) { - qsort (properties, n_properties, sizeof (GParamSpec *), compare_param_specs); + if (n_properties > 0) + qsort (properties, n_properties, sizeof (GParamSpec *), compare_param_specs); for (arg = 0; arg < n_properties; arg++) { GParamSpec *spec = properties[arg]; const gchar *nick, *blurb, *dot; @@ -1223,6 +1313,8 @@ def run(options): new_prerequisites_filename = base_filename + '.prerequisites.new' old_args_filename = base_filename + '.args' new_args_filename = base_filename + '.args.new' + old_actions_filename = base_filename + '.actions' + new_actions_filename = base_filename + '.actions.new' # generate a C program to scan the types @@ -1333,5 +1425,6 @@ def run(options): common.UpdateFileIfChanged(old_interfaces_filename, new_interfaces_filename, False) common.UpdateFileIfChanged(old_prerequisites_filename, new_prerequisites_filename, False) common.UpdateFileIfChanged(old_args_filename, new_args_filename, False) + common.UpdateFileIfChanged(old_actions_filename, new_actions_filename, False) return 0 diff --git a/help/Makefile.am b/help/Makefile.am index 6690244..54a15bd 100644 --- a/help/Makefile.am +++ b/help/Makefile.am @@ -4,4 +4,6 @@ if HAVE_YELP_TOOLS SUBDIRS = manual endif +EXTRA_DIST = meson.build + -include $(top_srcdir)/git.mk diff --git a/help/manual/C/index.docbook b/help/manual/C/index.docbook index 36b51fe..3d5330b 100644 --- a/help/manual/C/index.docbook +++ b/help/manual/C/index.docbook @@ -81,6 +81,12 @@ <revhistory> <revision> + <revnumber>1.33.0</revnumber> + <date>1 Oct 2020</date> + <authorinitials>mc</authorinitials> + <revremark>gtk4 version</revremark> + </revision> + <revision> <revnumber>1.32.1</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</authorinitials> @@ -1217,7 +1223,7 @@ gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html <para> More examples of what markdown tags are supported can be found in the - <ulink url="https://wiki.gnome.org/Projects/GTK%2B/DocumentationSyntax/Markdown">GTK+ Documentation Markdown Syntax Reference</ulink>. + <ulink url="https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/Markdown">GTK Documentation Markdown Syntax Reference</ulink>. </para> <tip> diff --git a/help/manual/Makefile.am b/help/manual/Makefile.am index b56fa4d..4da1c37 100644 --- a/help/manual/Makefile.am +++ b/help/manual/Makefile.am @@ -14,4 +14,6 @@ CLEANFILES = $(_HELP_LC_FILES) $(_HELP_LC_STAMPS) $(_HELP_MOFILES) GITIGNOREFILES = ??_??/$(HELP_ID).xml ??/$(HELP_ID).xml +EXTRA_DIST = meson.build + -include $(top_srcdir)/git.mk diff --git a/help/manual/cs/cs.po b/help/manual/cs/cs.po index f711794..bd380ab 100644 --- a/help/manual/cs/cs.po +++ b/help/manual/cs/cs.po @@ -6,8 +6,8 @@ msgid "" msgstr "" "Project-Id-Version: gtk-doc master\n" -"POT-Creation-Date: 2019-10-02 10:49+0000\n" -"PO-Revision-Date: 2020-03-08 10:38+0100\n" +"POT-Creation-Date: 2020-10-01 20:17+0000\n" +"PO-Revision-Date: 2020-10-05 20:45+0200\n" "Last-Translator: Marek Černocký <marek@manet.cz>\n" "Language-Team: čeština <gnome-cs-list@gnome.org>\n" "Language: cs\n" @@ -122,6 +122,15 @@ msgstr "" #. (itstool) path: revhistory/revision #: C/index.docbook:83 msgid "" +"<revnumber>1.33.0</revnumber> <date>1 Oct 2020</date> <authorinitials>mc</" +"authorinitials> <revremark>gtk4 version</revremark>" +msgstr "" +"<revnumber>1.33.0</revnumber> <date>1. října 2020</date> " +"<authorinitials>mc</authorinitials> <revremark>verze gtk4</revremark>" + +#. (itstool) path: revhistory/revision +#: C/index.docbook:89 +msgid "" "<revnumber>1.32.1</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</" "authorinitials> <revremark>dev version</revremark>" msgstr "" @@ -129,7 +138,7 @@ msgstr "" "<authorinitials>ss</authorinitials> <revremark>vývojová verze</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:89 +#: C/index.docbook:95 msgid "" "<revnumber>1.32</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</" "authorinitials> <revremark>hotfix release</revremark>" @@ -138,7 +147,7 @@ msgstr "" "authorinitials> <revremark>opravné vydání</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:95 +#: C/index.docbook:101 msgid "" "<revnumber>1.31</revnumber> <date>05 Aug 2019</date> <authorinitials>ss</" "authorinitials> <revremark>refactorings and more test coverage</revremark>" @@ -147,7 +156,7 @@ msgstr "" "authorinitials> <revremark>přepracování a větší pokrytí testy</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:101 +#: C/index.docbook:107 msgid "" "<revnumber>1.30</revnumber> <date>08 May 2019</date> <authorinitials>ss</" "authorinitials> <revremark>more test coverage</revremark>" @@ -156,7 +165,7 @@ msgstr "" "authorinitials> <revremark>větší pokrytí testy</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:107 +#: C/index.docbook:113 msgid "" "<revnumber>1.29</revnumber> <date>28 Aug 2018</date> <authorinitials>ss</" "authorinitials> <revremark>bug fixes</revremark>" @@ -165,7 +174,7 @@ msgstr "" "authorinitials> <revremark>opravy chyb</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:113 +#: C/index.docbook:119 msgid "" "<revnumber>1.28</revnumber> <date>24 Mar 2018</date> <authorinitials>ss</" "authorinitials> <revremark>bug fixes</revremark>" @@ -174,7 +183,7 @@ msgstr "" "authorinitials> <revremark>opravy chyb</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:119 +#: C/index.docbook:125 msgid "" "<revnumber>1.27</revnumber> <date>07 Dec 2017</date> <authorinitials>ss</" "authorinitials> <revremark>fine tuning of the python port</revremark>" @@ -184,7 +193,7 @@ msgstr "" "jazyce Python</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:125 +#: C/index.docbook:131 msgid "" "<revnumber>1.26</revnumber> <date>11 Aug 2017</date> <authorinitials>ss</" "authorinitials> <revremark>port all tools from perl/bash to python</" @@ -195,7 +204,7 @@ msgstr "" "jazyka Python</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:131 +#: C/index.docbook:137 msgid "" "<revnumber>1.25</revnumber> <date>21 March 2016</date> <authorinitials>ss</" "authorinitials> <revremark>bug fixes, test cleanups</revremark>" @@ -204,7 +213,7 @@ msgstr "" "authorinitials> <revremark>opravy chyb, pročištění testů</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:137 +#: C/index.docbook:143 msgid "" "<revnumber>1.24</revnumber> <date>29 May 2015</date> <authorinitials>ss</" "authorinitials> <revremark>bug fix</revremark>" @@ -213,7 +222,7 @@ msgstr "" "authorinitials> <revremark>oprava chyby</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:143 +#: C/index.docbook:149 msgid "" "<revnumber>1.23</revnumber> <date>17 May 2015</date> <authorinitials>ss</" "authorinitials> <revremark>bug fix</revremark>" @@ -222,7 +231,7 @@ msgstr "" "authorinitials> <revremark>oprava chyby</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:149 +#: C/index.docbook:155 msgid "" "<revnumber>1.22</revnumber> <date>07 May 2015</date> <authorinitials>ss</" "authorinitials> <revremark>bug fixes, dropping deprecated features</" @@ -233,7 +242,7 @@ msgstr "" "revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:155 +#: C/index.docbook:161 msgid "" "<revnumber>1.21</revnumber> <date>17 Jul 2014</date> <authorinitials>ss</" "authorinitials> <revremark>bug fixes, dropping deprecated features</" @@ -244,7 +253,7 @@ msgstr "" "zastaralých věcí</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:161 +#: C/index.docbook:167 msgid "" "<revnumber>1.20</revnumber> <date>16 Feb 2014</date> <authorinitials>ss</" "authorinitials> <revremark>bug fixes, markdown support, style improvements</" @@ -255,7 +264,7 @@ msgstr "" "vylepšení stylů</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:167 +#: C/index.docbook:173 msgid "" "<revnumber>1.19</revnumber> <date>05 Jun 2013</date> <authorinitials>ss</" "authorinitials> <revremark>bug fixes</revremark>" @@ -264,7 +273,7 @@ msgstr "" "authorinitials> <revremark>opravy chyb</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:173 +#: C/index.docbook:179 msgid "" "<revnumber>1.18</revnumber> <date>14 Sep 2011</date> <authorinitials>ss</" "authorinitials> <revremark>bug fixes, speedups, markdown support</revremark>" @@ -274,7 +283,7 @@ msgstr "" "jazyka</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:179 +#: C/index.docbook:185 msgid "" "<revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</" "authorinitials> <revremark>urgent bug fix update</revremark>" @@ -284,7 +293,7 @@ msgstr "" "revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:185 +#: C/index.docbook:191 msgid "" "<revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</" "authorinitials> <revremark>bugfixes, layout improvements</revremark>" @@ -293,7 +302,7 @@ msgstr "" "authorinitials> <revremark>opravy chyb, vylepšení vzhledu</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:191 +#: C/index.docbook:197 msgid "" "<revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</" "authorinitials> <revremark>bug and regression fixes</revremark>" @@ -302,7 +311,7 @@ msgstr "" "authorinitials> <revremark>opravy chyb a regresí</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:197 +#: C/index.docbook:203 msgid "" "<revnumber>1.14</revnumber> <date>28 March 2010</date> <authorinitials>sk</" "authorinitials> <revremark>bugfixes and performance improvements</revremark>" @@ -311,7 +320,7 @@ msgstr "" "authorinitials> <revremark>opravy chyb a vylepšení výkonu</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:203 +#: C/index.docbook:209 msgid "" "<revnumber>1.13</revnumber> <date>18 December 2009</date> " "<authorinitials>sk</authorinitials> <revremark>broken tarball update</" @@ -322,7 +331,7 @@ msgstr "" "balíčku</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:209 +#: C/index.docbook:215 msgid "" "<revnumber>1.12</revnumber> <date>18 December 2009</date> " "<authorinitials>sk</authorinitials> <revremark>new tool features and " @@ -333,7 +342,7 @@ msgstr "" "chyb</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:215 +#: C/index.docbook:221 msgid "" "<revnumber>1.11</revnumber> <date>16 November 2008</date> " "<authorinitials>mal</authorinitials> <revremark>GNOME doc-utils migration</" @@ -344,12 +353,12 @@ msgstr "" "GNOME</revremark>" #. (itstool) path: chapter/title -#: C/index.docbook:228 +#: C/index.docbook:234 msgid "Introduction" msgstr "Úvod" #. (itstool) path: chapter/para -#: C/index.docbook:230 +#: C/index.docbook:236 msgid "" "This chapter introduces GTK-Doc and gives an overview of what it is and how " "it is used." @@ -358,12 +367,12 @@ msgstr "" "použít." #. (itstool) path: sect1/title -#: C/index.docbook:236 +#: C/index.docbook:242 msgid "What is GTK-Doc?" msgstr "Co je to GTK-Doc?" #. (itstool) path: sect1/para -#: C/index.docbook:238 +#: C/index.docbook:244 msgid "" "GTK-Doc is used to document C code. It is typically used to document the " "public API of libraries, such as the GTK+ and GNOME libraries. But it can " @@ -374,12 +383,12 @@ msgstr "" "ale použít i k dokumentaci aplikačního kódu." #. (itstool) path: sect1/title -#: C/index.docbook:246 +#: C/index.docbook:252 msgid "How Does GTK-Doc Work?" msgstr "Jak GTK-Doc pracuje?" #. (itstool) path: sect1/para -#: C/index.docbook:248 +#: C/index.docbook:254 msgid "" "GTK-Doc works by using documentation of functions placed inside the source " "files in specially-formatted comment blocks, or documentation added to the " @@ -395,7 +404,7 @@ msgstr "" "nevytváří)." #. (itstool) path: sect1/para -#: C/index.docbook:255 +#: C/index.docbook:261 msgid "" "GTK-Doc consists of a number of python scripts, each performing a different " "step in the process." @@ -404,12 +413,12 @@ msgstr "" "část procesu." #. (itstool) path: sect1/para -#: C/index.docbook:260 +#: C/index.docbook:266 msgid "There are 5 main steps in the process:" msgstr "Celý proces se skládá z pěti hlavních kroků:" #. (itstool) path: listitem/para -#: C/index.docbook:267 +#: C/index.docbook:273 msgid "" "<guilabel>Writing the documentation.</guilabel> The author fills in the " "source files with the documentation for each function, macro, structs or " @@ -419,7 +428,7 @@ msgstr "" "kódem s dokumentací pro každou funkci, makro, strukturu, výčet atd." #. (itstool) path: listitem/para -#: C/index.docbook:276 +#: C/index.docbook:282 msgid "" "<guilabel>Gathering information about the code.</guilabel> " "<application>gtkdoc-scan</application> scans the header files of the code " @@ -453,7 +462,7 @@ msgstr "" "filename> do <filename><module>-overrides.txt</filename>." #. (itstool) path: listitem/para -#: C/index.docbook:293 +#: C/index.docbook:299 msgid "" "<application>gtkdoc-scangobj</application> can also be used to dynamically " "query a library about any GObject subclasses it exports. It saves " @@ -466,7 +475,7 @@ msgstr "" "signálech objektu GObject, které poskytují." #. (itstool) path: listitem/para -#: C/index.docbook:299 +#: C/index.docbook:305 msgid "" "<application>gtkdoc-scanobj</application> should not be used anymore. It was " "needed in the past when GObject was still GtkObject inside gtk+." @@ -475,7 +484,7 @@ msgstr "" "Bylo zapotřebí v minulosti, kdy byl GObject ještě GtkObject v rámci gtk+." #. (itstool) path: listitem/para -#: C/index.docbook:306 +#: C/index.docbook:312 msgid "" "<guilabel>Generating the XML and HTML/PDF.</guilabel> <application>gtkdoc-" "mkdb</application> turns the template files into XML files in the <filename " @@ -492,7 +501,7 @@ msgstr "" "zdrojového kódu a introspektivních dat." #. (itstool) path: listitem/para -#: C/index.docbook:315 +#: C/index.docbook:321 msgid "" "<application>gtkdoc-mkhtml</application> turns the XML files into HTML files " "in the <filename class=\"directory\">html/</filename> subdirectory. Likewise " @@ -505,7 +514,7 @@ msgstr "" "nazvaný <filename><balíček>.pdf</filename>." #. (itstool) path: listitem/para -#: C/index.docbook:321 +#: C/index.docbook:327 msgid "" "Files in <filename class=\"directory\">xml/</filename> and <filename class=" "\"directory\">html/</filename> directories are always overwritten. One " @@ -516,7 +525,7 @@ msgstr "" "neměly být upravovány přímo." #. (itstool) path: listitem/para -#: C/index.docbook:329 +#: C/index.docbook:335 msgid "" "<guilabel>Fixing up cross-references between documents.</guilabel> After " "installing the HTML files, <application>gtkdoc-fixxref</application> can be " @@ -538,23 +547,23 @@ msgstr "" "dokumenty, které jsou nainstalované)." #. (itstool) path: sect1/title -#: C/index.docbook:347 +#: C/index.docbook:353 msgid "Getting GTK-Doc" msgstr "Jak získat GTK-Doc?" #. (itstool) path: sect2/title -#: C/index.docbook:350 +#: C/index.docbook:356 msgid "Requirements" msgstr "Požadavky" #. (itstool) path: sect2/para -#: C/index.docbook:351 +#: C/index.docbook:357 msgid "" "<guilabel>python 2/3</guilabel> - the main scripts are written in python." msgstr "<guilabel>Python 2/3</guilabel> – hlavní skripty jsou v jazyce Python." #. (itstool) path: sect2/para -#: C/index.docbook:354 +#: C/index.docbook:360 msgid "" "<guilabel>xsltproc</guilabel> - the xslt processor from libxslt <ulink url=" "\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>" @@ -563,7 +572,7 @@ msgstr "" "\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>" #. (itstool) path: sect2/para -#: C/index.docbook:358 +#: C/index.docbook:364 msgid "" "<guilabel>docbook-xsl</guilabel> - the docbook xsl stylesheets <ulink url=" "\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\" type=\"http" @@ -574,7 +583,7 @@ msgstr "" "\">sourceforge.net/projects/docbook/files/docbook-xsl</ulink>" #. (itstool) path: sect2/para -#: C/index.docbook:362 +#: C/index.docbook:368 msgid "" "One of <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> " "or <guilabel>vim</guilabel> - optional - used for syntax highlighting of " @@ -585,12 +594,12 @@ msgstr "" "syntaxe u příkladů" #. (itstool) path: sect1/title -#: C/index.docbook:370 +#: C/index.docbook:376 msgid "About GTK-Doc" msgstr "O aplikaci GTK-Doc" #. (itstool) path: sect1/para -#: C/index.docbook:372 +#: C/index.docbook:378 msgid "" "Historically GTK-Doc was used to generate template files from the sources " "code. These template files could be used by developers to enter the API " @@ -608,12 +617,12 @@ msgstr "" "1.26 byla podpora šablon odstraněna." #. (itstool) path: sect1/para -#: C/index.docbook:382 C/index.docbook:396 +#: C/index.docbook:388 C/index.docbook:402 msgid "(FIXME)" msgstr "(DOPLNIT)" #. (itstool) path: sect1/para -#: C/index.docbook:386 +#: C/index.docbook:392 msgid "" "(authors, web pages, mailing list, license, future plans, comparison with " "other similar systems.)" @@ -622,22 +631,22 @@ msgstr "" "srovnání s ostatními podobnými systémy.)" #. (itstool) path: sect1/title -#: C/index.docbook:394 +#: C/index.docbook:400 msgid "About this Manual" msgstr "O této příručce" #. (itstool) path: sect1/para -#: C/index.docbook:400 +#: C/index.docbook:406 msgid "(who it is meant for, where you can get it, license)" msgstr "(k čemu je určená, kde ji můžete získat, licence)" #. (itstool) path: chapter/title -#: C/index.docbook:409 +#: C/index.docbook:415 msgid "Project Setup" msgstr "Nastavení projektu" #. (itstool) path: chapter/para -#: C/index.docbook:411 +#: C/index.docbook:417 msgid "" "This Chapter describes the steps that are necessary to integrate GTK-Doc " "into your project. The integration of GTK-Doc into a project includes the " @@ -647,7 +656,7 @@ msgstr "" "vašeho projektu. Integrace GTK-Doc do projektu zahrnuje následující kroky:" #. (itstool) path: listitem/para -#: C/index.docbook:419 +#: C/index.docbook:425 msgid "" "Preparation of the directory structure and creating required configuration " "files for your GTK-Doc documentation (see <link linkend=\"settingup_docfiles" @@ -658,7 +667,7 @@ msgstr "" "kostry dokumentace</link>)." #. (itstool) path: listitem/para -#: C/index.docbook:427 +#: C/index.docbook:433 msgid "" "Adjusting the build system to build your documentation using the GTK-Doc " "tools. Multiple build systems are supported, in this manual we describe how " @@ -673,7 +682,7 @@ msgstr "" "linkend=\"settingup_plain_makefiles\">prostými soubory Makefiles</link>." #. (itstool) path: listitem/para -#: C/index.docbook:437 +#: C/index.docbook:443 msgid "" "Adding GTK-Doc specific files to version control and deciding which files to " "ignore (see <link linkend=\"settingup_vcs\"> Integration with version " @@ -684,7 +693,7 @@ msgstr "" "systémem správy verzí</link>)." #. (itstool) path: chapter/para -#: C/index.docbook:445 +#: C/index.docbook:451 msgid "" "The following sections assume we work on a project called <code>meep</code>. " "This project contains two packages (or modules), a library called " @@ -696,12 +705,12 @@ msgstr "" "<code>meeper</code>." #. (itstool) path: sect1/title -#: C/index.docbook:454 +#: C/index.docbook:460 msgid "Setting up a skeleton documentation" msgstr "Nastavení kostry dokumentace" #. (itstool) path: sect1/para -#: C/index.docbook:456 +#: C/index.docbook:462 msgid "" "A common convention is to place documentation into a folder called " "<code>docs</code> inside your top-level project directory. We usually " @@ -733,12 +742,12 @@ msgstr "" "konfiguraci sestavovacího systému, aby se s ní shodoval." #. (itstool) path: example/title -#: C/index.docbook:487 +#: C/index.docbook:493 msgid "Example directory structure of <emphasis>meep</emphasis> project" msgstr "Příklad struktury složek projektu <emphasis>meep</emphasis>" #. (itstool) path: example/programlisting -#: C/index.docbook:489 +#: C/index.docbook:495 #, no-wrap msgid "" "\n" @@ -766,7 +775,7 @@ msgstr "" " meeper/\n" #. (itstool) path: sect1/para -#: C/index.docbook:481 +#: C/index.docbook:487 msgid "" "In the following sections we will assume a directory structure for our " "<emphasis>meep</emphasis> project that uses the above conventions. <_:" @@ -777,12 +786,12 @@ msgstr "" ">" #. (itstool) path: sect1/title -#: C/index.docbook:506 +#: C/index.docbook:512 msgid "Integration with Autotools" msgstr "Integrace s Autotools" #. (itstool) path: sect1/para -#: C/index.docbook:507 +#: C/index.docbook:513 msgid "" "Integration of GTK-Doc into an autotools-based build system requires the " "following steps:" @@ -791,7 +800,7 @@ msgstr "" "následující kroky:" #. (itstool) path: listitem/para -#: C/index.docbook:513 +#: C/index.docbook:519 msgid "" "Ensure that <application>gtkdocize</application> is run once before the " "<filename>configure</filename> script. If an <filename>autogen.sh</filename> " @@ -804,7 +813,7 @@ msgstr "" "přidejte volání <application>gtkdocize</application>." #. (itstool) path: listitem/para -#: C/index.docbook:521 +#: C/index.docbook:527 msgid "" "The main purpose of <application>gtkdocize</application> is to make the " "<filename>gtk-doc.make</filename> Makefile and the <filename>gtk-doc.m4</" @@ -817,7 +826,7 @@ msgstr "" "vytvořením odkazu." #. (itstool) path: listitem/para -#: C/index.docbook:530 +#: C/index.docbook:536 msgid "" "Add the necessary <application>autoconf</application> macros to " "<filename>configure.ac</filename> to enable GTK-Doc in your build system to " @@ -830,7 +839,7 @@ msgstr "" "<filename>configure</filename>." #. (itstool) path: listitem/para -#: C/index.docbook:536 +#: C/index.docbook:542 msgid "" "Among others with registers the <code>--enable-gtk-doc</code> option with " "the <filename>configure</filename> script." @@ -839,7 +848,7 @@ msgstr "" "skriptu <filename>configure</filename>." #. (itstool) path: listitem/para -#: C/index.docbook:542 +#: C/index.docbook:548 msgid "" "Create an <application>automake</application> script for each application or " "library in your project. In the example used in this documentation this step " @@ -850,7 +859,7 @@ msgstr "" "krok použit jak pro <code>meeper</code>, tak pro <code>libmeep</code>." #. (itstool) path: sect1/para -#: C/index.docbook:551 +#: C/index.docbook:557 msgid "" "In the following sections, we will perform the above steps in reverse order. " "We start with the <application>automake</application> scripts and work our " @@ -865,12 +874,12 @@ msgstr "" "dokumentaci." #. (itstool) path: sect2/title -#: C/index.docbook:561 +#: C/index.docbook:567 msgid "Integration with automake" msgstr "Integrace s automake" #. (itstool) path: sect2/para -#: C/index.docbook:563 +#: C/index.docbook:569 msgid "" "First copy the <filename>Makefile.am</filename> from the <filename class=" "\"directory\">examples</filename> sub-directory of the <ulink url=\"https://" @@ -891,7 +900,7 @@ msgstr "" "balíčků s dokumentací, opakujte tento krok pro každý z nich." #. (itstool) path: note/simpara -#: C/index.docbook:576 +#: C/index.docbook:582 msgid "" "Do not forget to add each <filename>Makefile.am</filename> to the " "<function>AC_CONFIG_FILES</function> macro in <filename>configure.ac</" @@ -906,12 +915,12 @@ msgstr "" "filename> do <function>AC_CONFIG_FILES</function>." #. (itstool) path: example/title -#: C/index.docbook:588 +#: C/index.docbook:594 msgid "Example directory structure with <filename>Makefiles.am</filename>" msgstr "Příklad struktury složek s <filename>Makefiles.am</filename>" #. (itstool) path: example/programlisting -#: C/index.docbook:591 +#: C/index.docbook:597 #, no-wrap msgid "" "\n" @@ -943,7 +952,7 @@ msgstr "" " meeper/\n" #. (itstool) path: sect2/para -#: C/index.docbook:607 +#: C/index.docbook:613 msgid "" "Next, you need to customize the copied Makefiles and provide values for the " "various parameters in each <filename>Makefile.am</filename>. All settings " @@ -965,7 +974,7 @@ msgstr "" "přepínačů." #. (itstool) path: listitem/para -#: C/index.docbook:631 +#: C/index.docbook:637 msgid "" "<option>DOC_MODULE</option> is used to provide the name of the package that " "is being documentated (e.g. <code>meeper</code>, or <code>libmeep</code>)." @@ -974,7 +983,7 @@ msgstr "" "dokumentován (např. <code>meeper</code> nebo <code>libmeep</code>)." #. (itstool) path: listitem/para -#: C/index.docbook:638 +#: C/index.docbook:644 msgid "" "<option>DOC_SOURCE_DIR</option> is used to specify the location of source " "directory which GTK-Doc searches for your API documentation. This will " @@ -986,7 +995,7 @@ msgstr "" "<code>DOC_SOURCE_DIR=$(top_srcdir)/src </code> nebo podsložka této složky." #. (itstool) path: listitem/para -#: C/index.docbook:651 +#: C/index.docbook:657 msgid "" "<option>HFILE_GLOB</option> and <option>CFILE_GLOB</option> are used for " "dependencies. Each option take a file-glob (e.g. <code>HFILE_GLOB=" @@ -999,7 +1008,7 @@ msgstr "" "kterýkoliv z odpovídajících souborů změní." #. (itstool) path: listitem/para -#: C/index.docbook:663 +#: C/index.docbook:669 msgid "" "<option>EXTRA_HFILES</option> allows to specify extra header files to " "include when scanning for API documentation, which are not found under " @@ -1012,7 +1021,7 @@ msgstr "" "$(top_srcdir}/contrib/extra.h</code>)." #. (itstool) path: listitem/para -#: C/index.docbook:673 +#: C/index.docbook:679 msgid "" "<option>IGNORE_HFILES</option> allows to specify header files or directories " "to ignore when scanning for API documentation. Use the basename of the file " @@ -1025,7 +1034,7 @@ msgstr "" "<code>IGNORE_HFILES=gtkdebug.h gtkintl.h private_code_folder</code>)." #. (itstool) path: listitem/para -#: C/index.docbook:683 +#: C/index.docbook:689 msgid "" "<option>HTML_IMAGES</option> allows to specify images files which will be " "copied into the <filename>html/</filename> directory of the generated " @@ -1040,7 +1049,7 @@ msgstr "" "stock_about_24.png</code>)." #. (itstool) path: listitem/para -#: C/index.docbook:696 +#: C/index.docbook:702 msgid "" "<option>content_files</option> allows to specify extra files that are " "included by <code>$(DOC_MAIN_SGML_FILE)</code> (e.g. <code> " @@ -1051,7 +1060,7 @@ msgstr "" "<code>content_files=running.xml building.xml changes-2.0.xml</code>)." #. (itstool) path: listitem/para -#: C/index.docbook:707 +#: C/index.docbook:713 msgid "" "<option>expand_content_files</option> allows to specify files where " "<emphasis>gtk-doc abbreviations</emphasis> such as <code>#GtkWidget</code> " @@ -1063,7 +1072,7 @@ msgstr "" "code>)." #. (itstool) path: sect2/para -#: C/index.docbook:625 +#: C/index.docbook:631 msgid "" "The following list explains the most relevant options. Check the example " "<filename>Makefile.am</filename> for additional options. <_:itemizedlist-1/>" @@ -1072,12 +1081,12 @@ msgstr "" "podívejte do ukázkového <filename>Makefile.am</filename>. <_:itemizedlist-1/>" #. (itstool) path: sect2/title -#: C/index.docbook:722 +#: C/index.docbook:728 msgid "Integration with autoconf" msgstr "Integrace s autoconf" #. (itstool) path: sect2/para -#: C/index.docbook:724 +#: C/index.docbook:730 msgid "" "Integration with <application>autoconf</application> is very simple and " "includes one required step and an additional optional (but recommended) " @@ -1094,7 +1103,7 @@ msgstr "" "argumenty pro <application>gtkdocize</application>." #. (itstool) path: warning/simpara -#: C/index.docbook:736 +#: C/index.docbook:742 msgid "" "Make sure that the <code>GTK_DOC_CHECK</code> macro is not indented. The " "macro must start at the beginning of the line and should not start with " @@ -1104,7 +1113,7 @@ msgstr "" "Makro musí začínat na začátku řádku a nesmí začínat bílými znaky." #. (itstool) path: sect2/para -#: C/index.docbook:743 +#: C/index.docbook:749 msgid "" "The second step is to add the <code>AC_CONFIG_MACRO_DIR(m4)</code> to your " "<filename>configure.ac</filename>. This is not required but helps " @@ -1125,12 +1134,12 @@ msgstr "" "uvést, kde soubor s definicí makra najít." #. (itstool) path: example/title -#: C/index.docbook:756 +#: C/index.docbook:762 msgid "Minimal integration with autoconf" msgstr "Minimální integrace s autoconf" #. (itstool) path: example/programlisting -#: C/index.docbook:757 +#: C/index.docbook:763 #, no-wrap msgid "" "\n" @@ -1146,12 +1155,12 @@ msgstr "" "GTK_DOC_CHECK([1.28])\n" #. (itstool) path: example/title -#: C/index.docbook:772 +#: C/index.docbook:778 msgid "Integration with optional gtk-doc dependency" msgstr "Integrace s volitelnými závislostttmi gtk-doc" #. (itstool) path: example/programlisting -#: C/index.docbook:773 +#: C/index.docbook:779 #, no-wrap msgid "" "\n" @@ -1175,7 +1184,7 @@ msgstr "" "])\n" #. (itstool) path: sect2/para -#: C/index.docbook:766 +#: C/index.docbook:772 msgid "" "The above example works, but will require all developers to have gtk-doc " "installed. A better way is to make building the documentation optional as " @@ -1186,7 +1195,7 @@ msgstr "" "bylo volitelné, jak je ukázáno v následujícím příkladu: <_:example-1/>" #. (itstool) path: sect2/para -#: C/index.docbook:786 +#: C/index.docbook:792 msgid "" "The first argument is used to check for the Gtk-Doc version at configure " "time. The 2nd, optional argument is used by <application>gtkdocize</" @@ -1199,31 +1208,31 @@ msgstr "" "přepínačů pro configure:" #. (itstool) path: listitem/para -#: C/index.docbook:795 +#: C/index.docbook:801 msgid "--with-html-dir=PATH : path to installed docs" msgstr "--with-html-dir=CESTA: cesta, kam se má dokumentace nainstalovat" #. (itstool) path: listitem/para -#: C/index.docbook:796 +#: C/index.docbook:802 msgid "--enable-gtk-doc : use gtk-doc to build documentation [default=no]" msgstr "" "--enable-gtk-doc: použít k sestavení dokumentace gtk-doc [výchozí je ne]" #. (itstool) path: listitem/para -#: C/index.docbook:797 +#: C/index.docbook:803 msgid "" "--enable-gtk-doc-html : build documentation in html format [default=yes]" msgstr "" "--enable-gtk-doc-html: sestavit dokumentaci ve formátu HTML [výchozí je ano]" #. (itstool) path: listitem/para -#: C/index.docbook:798 +#: C/index.docbook:804 msgid "--enable-gtk-doc-pdf : build documentation in pdf format [default=no]" msgstr "" "--enable-gtk-doc-pdf: sestavit dokumentaci ve formátu PDF [výchozí je ne]" #. (itstool) path: important/para -#: C/index.docbook:802 +#: C/index.docbook:808 msgid "" "GTK-Doc is disabled by default! Remember to pass the option <option>'--" "enable-gtk-doc'</option> to the next <filename>configure</filename> run. " @@ -1236,7 +1245,7 @@ msgstr "" "uživatele, ale ne pro vývojáře)." #. (itstool) path: sect2/para -#: C/index.docbook:810 +#: C/index.docbook:816 msgid "" "After all changes to <filename>configure.ac</filename> are made, update the " "<filename>configure</filename> file. This can be done by re-running " @@ -1247,12 +1256,12 @@ msgstr "" "<code>autogen.sh</code>." #. (itstool) path: sect2/title -#: C/index.docbook:818 +#: C/index.docbook:824 msgid "Integration with autogen" msgstr "Integrace s autogen" #. (itstool) path: sect2/para -#: C/index.docbook:820 +#: C/index.docbook:826 msgid "" "Most projects will have an <filename>autogen.sh</filename> script to setup " "the build infrastructure after the project was checked out from a version " @@ -1267,17 +1276,17 @@ msgstr "" "nezbytných souborů požadovaných GTK-Doc do zdrojové složky." #. (itstool) path: sect2/para -#: C/index.docbook:828 +#: C/index.docbook:834 msgid "It should be run before autoreconf, autoheader, automake or autoconf." msgstr "Měl by být spuštěn před autoheader, automake nebo autoconf." #. (itstool) path: example/title -#: C/index.docbook:833 +#: C/index.docbook:839 msgid "Running gtkdocize from autogen.sh" msgstr "Spuštění gtkdocize z autogen.sh" #. (itstool) path: example/programlisting -#: C/index.docbook:834 +#: C/index.docbook:840 #, no-wrap msgid "" "\n" @@ -1287,12 +1296,12 @@ msgstr "" "gtkdocize || exit 1\n" #. (itstool) path: example/title -#: C/index.docbook:842 +#: C/index.docbook:848 msgid "Conditionally run gtkdocize from autogen.sh" msgstr "Podmíněné spuštění gtkdocize z autogen.sh" #. (itstool) path: example/programlisting -#: C/index.docbook:843 +#: C/index.docbook:849 #, no-wrap msgid "" "\n" @@ -1312,7 +1321,7 @@ msgstr "" "fi\n" #. (itstool) path: sect2/para -#: C/index.docbook:854 +#: C/index.docbook:860 msgid "" "When running <application>gtkdocize</application> it copies <filename>gtk-" "doc.make</filename> to your project root (or any directory specified by the " @@ -1323,7 +1332,7 @@ msgstr "" "option>) soubor <filename>gtk-doc.make</filename>." #. (itstool) path: sect2/para -#: C/index.docbook:860 +#: C/index.docbook:866 msgid "" "<application>gtkdocize</application> checks your <filename>configure.ac</" "filename> script for the <function>GTK_DOC_CHECK</function> macro. The " @@ -1337,7 +1346,7 @@ msgstr "" "application>. Konkrétně k tomu slouží druhý argument makra." #. (itstool) path: sect2/para -#: C/index.docbook:869 +#: C/index.docbook:875 msgid "" "Alternatively, additional arguments can also be passed to " "<application>gtkdocize</application> via the <function>GTKDOCIZE_FLAGS</" @@ -1350,12 +1359,12 @@ msgstr "" "v <filename>autogen.sh</filename>." #. (itstool) path: sect2/title -#: C/index.docbook:880 +#: C/index.docbook:886 msgid "Executing GTK-Doc from the Build System" msgstr "Spouštění GTK-Doc ze sestavovacího systému" #. (itstool) path: sect2/para -#: C/index.docbook:882 +#: C/index.docbook:888 msgid "" "After the previous steps it's time to run the build. First we need to rerun " "<filename>autogen.sh</filename>. If this script runs configure for you, then " @@ -1368,7 +1377,7 @@ msgstr "" "Jinak potom ručně spusťte <filename>configure</filename> s tímto přepínačem." #. (itstool) path: sect2/para -#: C/index.docbook:889 +#: C/index.docbook:895 msgid "" "The first make run generates several additional files in the doc-" "directories. The important ones are: <filename><package>.types</" @@ -1381,12 +1390,12 @@ msgstr "" "package>-sections.txt</filename>." #. (itstool) path: example/title -#: C/index.docbook:897 +#: C/index.docbook:903 msgid "Running the doc build" msgstr "Sestavení dokumentace" #. (itstool) path: example/programlisting -#: C/index.docbook:898 +#: C/index.docbook:904 #, no-wrap msgid "" "\n" @@ -1398,7 +1407,7 @@ msgstr "" "make\n" #. (itstool) path: sect2/para -#: C/index.docbook:905 +#: C/index.docbook:911 msgid "" "Now you can point your browser to <filename>docs/reference/<package>/" "index.html</filename>. With this initial setup you will only see a very " @@ -1419,12 +1428,12 @@ msgstr "" "doplňující kapitoly a oddíly." #. (itstool) path: sect1/title -#: C/index.docbook:921 +#: C/index.docbook:927 msgid "Integration with CMake build systems" msgstr "Integrace se sestavovacím systémem CMake" #. (itstool) path: sect1/para -#: C/index.docbook:923 +#: C/index.docbook:929 msgid "" "GTK-Doc now provides a <filename>GtkDocConfig.cmake</filename> module (and " "the corresponding <filename>GtkDocConfigVersion.cmake</filename> module). " @@ -1437,12 +1446,12 @@ msgstr "" "nastavit ve svém souboru <filename>CMakeLists.txt</filename>." #. (itstool) path: example/title -#: C/index.docbook:933 +#: C/index.docbook:939 msgid "Example of using GTK-Doc from CMake" msgstr "Příklad použití GTK-Doc z CMake" #. (itstool) path: example/programlisting -#: C/index.docbook:934 +#: C/index.docbook:940 #, no-wrap msgid "" "\n" @@ -1484,18 +1493,18 @@ msgstr "" " DESTINATION ${CMAKE_INSTALL_DOCDIR})\n" #. (itstool) path: sect1/para -#: C/index.docbook:931 +#: C/index.docbook:937 msgid "The following example shows how to use this command. <_:example-1/>" msgstr "Následující příklad ukazuje, jak tento příkaz použít: <_:example-1/>" #. (itstool) path: sect1/title -#: C/index.docbook:958 +#: C/index.docbook:964 msgid "Integration with plain makefiles or other build systems" msgstr "" "Integrace s prostými soubory Makefile nebo jinými sestavovacími systémy" #. (itstool) path: sect1/para -#: C/index.docbook:960 +#: C/index.docbook:966 msgid "" "In the case one does not want to use automake and therefore <filename>gtk-" "doc.mak</filename> one will need to call the gtkdoc tools in the right order " @@ -1506,12 +1515,12 @@ msgstr "" "souborech make (nebo jiných nástrojích)." #. (itstool) path: example/title -#: C/index.docbook:967 +#: C/index.docbook:973 msgid "Documentation build steps" msgstr "Kroky sestavení dokumentace" #. (itstool) path: example/programlisting -#: C/index.docbook:968 +#: C/index.docbook:974 #, no-wrap msgid "" "\n" @@ -1537,7 +1546,7 @@ msgstr "" "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n" #. (itstool) path: sect1/para -#: C/index.docbook:982 +#: C/index.docbook:988 msgid "" "One will need to look at the <filename>Makefile.am</filename> and " "<filename>gtk-doc.mak</filename> to pick the extra options needed." @@ -1546,12 +1555,12 @@ msgstr "" "am</filename> a <filename>gtk-doc.mak</filename>." #. (itstool) path: sect1/title -#: C/index.docbook:989 +#: C/index.docbook:995 msgid "Integration with version control systems" msgstr "Integrace se systémem pro správu verzí" #. (itstool) path: sect1/para -#: C/index.docbook:991 +#: C/index.docbook:997 msgid "" "As a rule of thumb, it's the files you edit which should go under version " "control. For typical projects it's these files: <filename><package>." @@ -1566,7 +1575,7 @@ msgstr "" "<filename>Makefile.am</filename>." #. (itstool) path: sect1/para -#: C/index.docbook:999 +#: C/index.docbook:1005 msgid "" "Files in the <filename>xml/</filename> and <filename>html/</filename> " "directories should not go under version control. Neither should any of the " @@ -1577,12 +1586,12 @@ msgstr "" "filename>." #. (itstool) path: chapter/title -#: C/index.docbook:1009 +#: C/index.docbook:1015 msgid "Documenting the code" msgstr "Dokumentování v kódu" #. (itstool) path: chapter/para -#: C/index.docbook:1011 +#: C/index.docbook:1017 msgid "" "GTK-Doc uses source code comment with a special syntax for code " "documentation. Further it retrieves information about your project structure " @@ -1595,12 +1604,12 @@ msgstr "" "syntaxi komentářů." #. (itstool) path: example/title -#: C/index.docbook:1022 C/index.docbook:1048 +#: C/index.docbook:1028 C/index.docbook:1054 msgid "GTK-Doc comment block" msgstr "Komentářový blok GTK-Doc" #. (itstool) path: example/programlisting -#: C/index.docbook:1023 +#: C/index.docbook:1029 #, no-wrap msgid "" "\n" @@ -1614,7 +1623,7 @@ msgstr "" "#endif\n" #. (itstool) path: chapter/para -#: C/index.docbook:1018 +#: C/index.docbook:1024 msgid "" "The GTK-Doc scanner can handle the majority of C headers fine. In the case " "of receiving warnings from the scanner that look like a special case, one " @@ -1625,12 +1634,12 @@ msgstr "" "poradit, aby jej přeskakovala. <_:example-1/>" #. (itstool) path: note/title -#: C/index.docbook:1032 +#: C/index.docbook:1038 msgid "Limitations" msgstr "Omezení" #. (itstool) path: note/para -#: C/index.docbook:1033 +#: C/index.docbook:1039 msgid "" "Note, that GTK-Doc's supports <code>#ifndef(__GTK_DOC_IGNORE__)</code> but " "not <code>#if !defined(__GTK_DOC_IGNORE__)</code> or other combinations." @@ -1639,12 +1648,12 @@ msgstr "" "ale ne <code>#if !defined(__GTK_DOC_IGNORE__)</code> nebo jiné kombinace." #. (itstool) path: sect1/title -#: C/index.docbook:1043 +#: C/index.docbook:1049 msgid "Documentation comments" msgstr "Dokumentační komentáře" #. (itstool) path: example/programlisting -#: C/index.docbook:1049 +#: C/index.docbook:1055 #, no-wrap msgid "" "\n" @@ -1660,7 +1669,7 @@ msgstr "" " */\n" #. (itstool) path: sect1/para -#: C/index.docbook:1045 +#: C/index.docbook:1051 msgid "" "A multiline comment that starts with an additional '*' marks a documentation " "block that will be processed by the GTK-Doc tools. <_:example-1/>" @@ -1669,7 +1678,7 @@ msgstr "" "dokumentačním blokem a bude zpracovaný nástroji GTK-Doc. <_:example-1/>" #. (itstool) path: sect1/para -#: C/index.docbook:1058 +#: C/index.docbook:1064 msgid "" "The 'identifier' is one line with the name of the item the comment is " "related to. The syntax differs a little depending on the item. (TODO add " @@ -1680,7 +1689,7 @@ msgstr "" "se seznamem identifikátorů)" #. (itstool) path: sect1/para -#: C/index.docbook:1064 +#: C/index.docbook:1070 msgid "" "The 'documentation' block is also different for each symbol type. Symbol " "types that get parameters such as functions or macros have the parameter " @@ -1699,7 +1708,7 @@ msgstr "" "hvězdička mezera mezera). To se hodí na text s pevným formátem (výpis kódu)." #. (itstool) path: listitem/para -#: C/index.docbook:1081 +#: C/index.docbook:1087 msgid "" "What it is: The name for a class or function can sometimes be misleading for " "people coming from a different background." @@ -1708,26 +1717,26 @@ msgstr "" "používají něco jiného." #. (itstool) path: listitem/para -#: C/index.docbook:1087 +#: C/index.docbook:1093 msgid "" "What it does: Tell about common uses. Put it in relation with the other API." msgstr "" "K čemu to je: Uveďte běžném použití. Dejte ho do souvislosti se zbytkem API." #. (itstool) path: tip/para -#: C/index.docbook:1077 +#: C/index.docbook:1083 msgid "When documenting code, describe two aspects: <_:itemizedlist-1/>" msgstr "" "Když píšete dokumentaci ke kódu, popište dva aspekty: <_:itemizedlist-1/>" #. (itstool) path: listitem/para -#: C/index.docbook:1102 +#: C/index.docbook:1108 msgid "Use function() to refer to functions or macros which take arguments." msgstr "" "Použijte funkce() pro odkaz na funkci nebo makro, které mají argumenty." #. (itstool) path: listitem/para -#: C/index.docbook:1107 +#: C/index.docbook:1113 msgid "" "Use @param to refer to parameters. Also use this when referring to " "parameters of other functions, related to the one being described." @@ -1736,12 +1745,12 @@ msgstr "" "odkazujete na parametry jiných funkcí, vztahujících se k popisované funkci." #. (itstool) path: listitem/para -#: C/index.docbook:1113 +#: C/index.docbook:1119 msgid "Use %constant to refer to a constant, e.g. %G_TRAVERSE_LEAFS." msgstr "Použijte %konstanta pro odkaz na konstantu, např. %G_TRAVERSE_LEAFS." #. (itstool) path: listitem/para -#: C/index.docbook:1118 +#: C/index.docbook:1124 msgid "" "Use #symbol to refer to other types of symbol, e.g. structs and enums and " "macros which don't take arguments." @@ -1750,17 +1759,17 @@ msgstr "" "makro, který nemá argumenty." #. (itstool) path: listitem/para -#: C/index.docbook:1124 +#: C/index.docbook:1130 msgid "Use #Object::signal to refer to a GObject signal." msgstr "Použijte #Objekt::signál pro odkaz na signál objektu GObject." #. (itstool) path: listitem/para -#: C/index.docbook:1129 +#: C/index.docbook:1135 msgid "Use #Object:property to refer to a GObject property." msgstr "Použijte #Objekt:vlastnost pro odkaz na vlastnost objektu GObject." #. (itstool) path: listitem/para -#: C/index.docbook:1134 +#: C/index.docbook:1140 msgid "" "Use #Struct.field to refer to a field inside a structure and #GObjectClass." "foo_bar() to refer to a vmethod." @@ -1769,7 +1778,7 @@ msgstr "" "neco() pro odkaz na virtuální metodu." #. (itstool) path: sect1/para -#: C/index.docbook:1096 +#: C/index.docbook:1102 msgid "" "One advantage of hyper-text over plain-text is the ability to have links in " "the document. Writing the correct markup for a link can be tedious though. " @@ -1781,7 +1790,7 @@ msgstr "" "vám snaží pomoci několika užitečnými zkratkami. <_:itemizedlist-1/>" #. (itstool) path: tip/para -#: C/index.docbook:1143 +#: C/index.docbook:1149 msgid "" "If you need to use the special characters '<', '>', '()', '@', '%', or " "'#' in your documentation without GTK-Doc changing them you can use the XML " @@ -1796,7 +1805,7 @@ msgstr "" "se zpětným lomítkem „\\“." #. (itstool) path: sect1/para -#: C/index.docbook:1152 +#: C/index.docbook:1158 msgid "" "DocBook can do more than just links. One can also have lists, examples, " "headings, and images. As of version 1.20, the preferred way is to use a " @@ -1814,7 +1823,7 @@ msgstr "" "začátku." #. (itstool) path: sect1/para -#: C/index.docbook:1163 +#: C/index.docbook:1169 msgid "" "While markdown is now preferred one can mix both. One limitation here is " "that one can use docbook xml within markdown, but markdown within docbook " @@ -1825,7 +1834,7 @@ msgstr "" "markdown v docbook xml podporován není." #. (itstool) path: sect1/para -#: C/index.docbook:1169 +#: C/index.docbook:1175 msgid "" "In older GTK-Doc releases, if you need support for additional formatting, " "you would need to enable the usage of docbook XML tags inside doc-comments " @@ -1840,12 +1849,12 @@ msgstr "" "<filename>Makefile.am</filename>." #. (itstool) path: example/title -#: C/index.docbook:1178 +#: C/index.docbook:1184 msgid "GTK-Doc comment block using Markdown" msgstr "Komentářový blok GTK-Doc používající značkovací jazyk" #. (itstool) path: example/programlisting -#: C/index.docbook:1179 +#: C/index.docbook:1185 #, no-wrap msgid "" "\n" @@ -1921,18 +1930,18 @@ msgstr "" " */\n" #. (itstool) path: sect1/para -#: C/index.docbook:1218 +#: C/index.docbook:1224 msgid "" "More examples of what markdown tags are supported can be found in the <ulink " -"url=\"https://wiki.gnome.org/Projects/GTK%2B/DocumentationSyntax/Markdown" -"\">GTK+ Documentation Markdown Syntax Reference</ulink>." +"url=\"https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/Markdown\">GTK " +"Documentation Markdown Syntax Reference</ulink>." msgstr "" "Více příkladů k podporovaným značkám Markdown můžete najít v <ulink url=" -"\"https://wiki.gnome.org/Projects/GTK%2B/DocumentationSyntax/Markdown" -"\">Referenční příručce k syntaxi Markdown pro dokumentaci GTK+</ulink>." +"\"https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/Markdown" +"\">Referenční příručce k syntaxi Markdown pro dokumentaci GTK</ulink>." #. (itstool) path: tip/para -#: C/index.docbook:1224 +#: C/index.docbook:1230 msgid "" "As already mentioned earlier GTK-Doc is for documenting public API. Thus one " "cannot write documentation for static symbols. Nevertheless it is good to " @@ -1951,12 +1960,12 @@ msgstr "" "jednu „*“ a na správné místo v souboru oddílů vložit název symbolu." #. (itstool) path: sect1/title -#: C/index.docbook:1239 +#: C/index.docbook:1245 msgid "Documenting sections" msgstr "Dokumentování oddílů" #. (itstool) path: sect1/para -#: C/index.docbook:1241 +#: C/index.docbook:1247 msgid "" "Each section of the documentation contains information about one class or " "module. To introduce the component one can write a section block. The short " @@ -1968,12 +1977,12 @@ msgstr "" "použije v rámci tabulky s obsahem. Všechna @pole jsou volitelná." #. (itstool) path: example/title -#: C/index.docbook:1249 +#: C/index.docbook:1255 msgid "Section comment block" msgstr "Komentářový blok oddílu" #. (itstool) path: example/programlisting -#: C/index.docbook:1250 +#: C/index.docbook:1256 #, no-wrap msgid "" "\n" @@ -2005,12 +2014,12 @@ msgstr "" " */\n" #. (itstool) path: varlistentry/term -#: C/index.docbook:1269 +#: C/index.docbook:1275 msgid "SECTION:<name>" msgstr "SECTION:<název>" #. (itstool) path: listitem/para -#: C/index.docbook:1271 +#: C/index.docbook:1277 msgid "" "The name links the section documentation to the respective part in the " "<filename><package>-sections.txt</filename> file. The name given here " @@ -2022,12 +2031,12 @@ msgstr "" "<SOUBOR> v souboru <filename><package>-sections.txt</filename>." #. (itstool) path: varlistentry/term -#: C/index.docbook:1280 +#: C/index.docbook:1286 msgid "@short_description" msgstr "@short_description" #. (itstool) path: listitem/para -#: C/index.docbook:1282 +#: C/index.docbook:1288 msgid "" "A one line description of the section, that later will appear after the " "links in the TOC and at the top of the section page." @@ -2036,12 +2045,12 @@ msgstr "" "obsahem a na začátku stránky oddílu." #. (itstool) path: varlistentry/term -#: C/index.docbook:1289 +#: C/index.docbook:1295 msgid "@title" msgstr "@title" #. (itstool) path: listitem/para -#: C/index.docbook:1291 +#: C/index.docbook:1297 msgid "" "The section title defaults to <name> from the SECTION declaration. It " "can be overridden with the @title field." @@ -2050,12 +2059,12 @@ msgstr "" "jej ale určit i přímo v poli @title." #. (itstool) path: varlistentry/term -#: C/index.docbook:1298 +#: C/index.docbook:1304 msgid "@section_id" msgstr "@section_id" #. (itstool) path: listitem/para -#: C/index.docbook:1300 +#: C/index.docbook:1306 msgid "" "Overrides the use of title as a section identifier. For GObjects the <" "title> is used as a section_id and for other sections it is <" @@ -2066,22 +2075,22 @@ msgstr "" "MODULE>-<title>." #. (itstool) path: varlistentry/term -#: C/index.docbook:1308 +#: C/index.docbook:1314 msgid "@see_also" msgstr "@see_also" #. (itstool) path: listitem/para -#: C/index.docbook:1310 +#: C/index.docbook:1316 msgid "A list of symbols that are related to this section." msgstr "Seznam symbolů, které se vztahují k tomuto oddílu." #. (itstool) path: varlistentry/term -#: C/index.docbook:1316 +#: C/index.docbook:1322 msgid "@stability" msgstr "@stability" #. (itstool) path: listitem/para -#: C/index.docbook:1323 +#: C/index.docbook:1329 msgid "" "Stable - The intention of a Stable interface is to enable arbitrary third " "parties to develop applications to these interfaces, release them, and have " @@ -2097,7 +2106,7 @@ msgstr "" "nekompatibilní změny očekávají zřídka v opravdu odůvodněných případech." #. (itstool) path: listitem/para -#: C/index.docbook:1335 +#: C/index.docbook:1341 msgid "" "Unstable - Unstable interfaces are experimental or transitional. They are " "typically used to give outside developers early access to new or rapidly " @@ -2113,7 +2122,7 @@ msgstr "" "následujíc." #. (itstool) path: listitem/para -#: C/index.docbook:1347 +#: C/index.docbook:1353 msgid "" "Private - An interface that can be used within the GNOME stack itself, but " "that is not documented for end-users. Such functions should only be used in " @@ -2124,7 +2133,7 @@ msgstr "" "měly používat jen určeným a dokumentovaným způsobem." #. (itstool) path: listitem/para -#: C/index.docbook:1356 +#: C/index.docbook:1362 msgid "" "Internal - An interface that is internal to a module and does not require " "end-user documentation. Functions that are undocumented are assumed to be " @@ -2135,7 +2144,7 @@ msgstr "" "nedokumentované, jsou považované za interní." #. (itstool) path: listitem/para -#: C/index.docbook:1318 +#: C/index.docbook:1324 msgid "" "An informal description of the stability level this API has. We recommend " "the use of one of these terms: <_:itemizedlist-1/>" @@ -2144,12 +2153,12 @@ msgstr "" "těchto termínů: <_:itemizedlist-1/>" #. (itstool) path: varlistentry/term -#: C/index.docbook:1368 +#: C/index.docbook:1374 msgid "@include" msgstr "@include" #. (itstool) path: listitem/para -#: C/index.docbook:1370 +#: C/index.docbook:1376 msgid "" "The <literal>#include</literal> files to show in the section synopsis (a " "comma separated list), overriding the global value from the <link linkend=" @@ -2162,12 +2171,12 @@ msgstr "" "položka je volitelná." #. (itstool) path: varlistentry/term -#: C/index.docbook:1379 +#: C/index.docbook:1385 msgid "@image" msgstr "@image" #. (itstool) path: listitem/para -#: C/index.docbook:1381 +#: C/index.docbook:1387 msgid "" "The image to display at the top of the reference page for this section. This " "will often be some sort of a diagram to illustrate the visual appearance of " @@ -2179,7 +2188,7 @@ msgstr "" "nebo nákres se vztahy vůči jiným třídám. Tato položka je volitelná." #. (itstool) path: tip/para -#: C/index.docbook:1392 +#: C/index.docbook:1398 msgid "" "To avoid unnecessary recompilation after doc-changes put the section docs " "into the c-source where possible." @@ -2188,12 +2197,12 @@ msgstr "" "vložte, kde je to možné, dokumentaci oddílu do zdrojového kódu c." #. (itstool) path: sect1/title -#: C/index.docbook:1401 +#: C/index.docbook:1407 msgid "Documenting symbols" msgstr "Dokumentování symbolů" #. (itstool) path: sect1/para -#: C/index.docbook:1403 +#: C/index.docbook:1409 msgid "" "Each symbol (function, macro, struct, enum, signal and property) is " "documented in a separate block. The block is best placed close to the " @@ -2209,12 +2218,12 @@ msgstr "" #. (itstool) path: sect2/title #. (itstool) path: example/title -#: C/index.docbook:1411 C/index.docbook:1477 +#: C/index.docbook:1417 C/index.docbook:1483 msgid "General tags" msgstr "Obecné značky" #. (itstool) path: sect2/para -#: C/index.docbook:1413 +#: C/index.docbook:1419 msgid "" "You can add versioning information to all documentation elements to tell " "when an API was introduced, or when it was deprecated." @@ -2223,27 +2232,27 @@ msgstr "" "sdělili, kdy bylo API zavedeno, nebo kdy bylo označeno za zastaralé." #. (itstool) path: variablelist/title -#: C/index.docbook:1418 +#: C/index.docbook:1424 msgid "Versioning Tags" msgstr "Značky pro verzování" #. (itstool) path: varlistentry/term -#: C/index.docbook:1419 +#: C/index.docbook:1425 msgid "Since:" msgstr "Since:" #. (itstool) path: listitem/para -#: C/index.docbook:1421 +#: C/index.docbook:1427 msgid "Description since which version of the code the API is available." msgstr "Popisuje, od které verze kódu je API dostupné." #. (itstool) path: varlistentry/term -#: C/index.docbook:1426 +#: C/index.docbook:1432 msgid "Deprecated:" msgstr "Deprecated:" #. (itstool) path: listitem/para -#: C/index.docbook:1428 +#: C/index.docbook:1434 msgid "" "Paragraph denoting that this function should no be used anymore. The " "description should point the reader to the new API." @@ -2252,7 +2261,7 @@ msgstr "" "měl čtenáře odkazovat na nové API." #. (itstool) path: sect2/para -#: C/index.docbook:1436 +#: C/index.docbook:1442 msgid "" "You can also add stability information to all documentation elements to " "indicate whether API stability is guaranteed for them for all future minor " @@ -2263,7 +2272,7 @@ msgstr "" "minoritní vydání projektu." #. (itstool) path: sect2/para -#: C/index.docbook:1442 +#: C/index.docbook:1448 msgid "" "The default stability level for all documentation elements can be set by " "passing the <option>--default-stability</option> argument to " @@ -2274,17 +2283,17 @@ msgstr "" "do <application>gtkdoc-mkdb</application>." #. (itstool) path: variablelist/title -#: C/index.docbook:1448 +#: C/index.docbook:1454 msgid "Stability Tags" msgstr "Značky pro stabilitu" #. (itstool) path: varlistentry/term -#: C/index.docbook:1449 +#: C/index.docbook:1455 msgid "Stability: Stable" msgstr "Stability: Stable" #. (itstool) path: listitem/para -#: C/index.docbook:1451 +#: C/index.docbook:1457 msgid "" "Mark the element as stable. This is for public APIs which are guaranteed to " "remain stable for all future minor releases of the project." @@ -2293,12 +2302,12 @@ msgstr "" "že zůstanou stabilní po všechna minoritní vydání projektu." #. (itstool) path: varlistentry/term -#: C/index.docbook:1458 +#: C/index.docbook:1464 msgid "Stability: Unstable" msgstr "Stability: Unstable" #. (itstool) path: listitem/para -#: C/index.docbook:1460 +#: C/index.docbook:1466 msgid "" "Mark the element as unstable. This is for public APIs which are released as " "a preview before being stabilised." @@ -2307,12 +2316,12 @@ msgstr "" "vydána jako ukázky před tím, než jsou stabilizována." #. (itstool) path: varlistentry/term -#: C/index.docbook:1466 +#: C/index.docbook:1472 msgid "Stability: Private" msgstr "Stability: Private" #. (itstool) path: listitem/para -#: C/index.docbook:1468 +#: C/index.docbook:1474 msgid "" "Mark the element as private. This is for interfaces which can be used by " "tightly coupled modules, but not by arbitrary third parties." @@ -2321,7 +2330,7 @@ msgstr "" "použita přímo v modulu, ale ne kterýmikoliv třetími stranami." #. (itstool) path: example/programlisting -#: C/index.docbook:1478 +#: C/index.docbook:1484 #, no-wrap msgid "" "\n" @@ -2360,12 +2369,12 @@ msgstr "" #. (itstool) path: sect2/title #. (itstool) path: example/title -#: C/index.docbook:1498 C/index.docbook:1508 +#: C/index.docbook:1504 C/index.docbook:1514 msgid "Annotations" msgstr "Anotace" #. (itstool) path: sect2/para -#: C/index.docbook:1500 +#: C/index.docbook:1506 msgid "" "Documentation blocks can contain annotation-tags. These tags will be " "rendered with tooltips describing their meaning. The tags are used by " @@ -2380,7 +2389,7 @@ msgstr "" "org/GObjectIntrospection/Annotations\" type=\"http\">wiki</ulink>." #. (itstool) path: example/programlisting -#: C/index.docbook:1509 +#: C/index.docbook:1515 #, no-wrap msgid "" "\n" @@ -2421,12 +2430,12 @@ msgstr "" #. (itstool) path: sect2/title #. (itstool) path: example/title -#: C/index.docbook:1530 C/index.docbook:1559 +#: C/index.docbook:1536 C/index.docbook:1565 msgid "Function comment block" msgstr "Komentářový blok pro funkci" #. (itstool) path: listitem/para -#: C/index.docbook:1536 +#: C/index.docbook:1542 msgid "" "Document whether returned objects, lists, strings, etc, should be freed/" "unrefed/released." @@ -2435,24 +2444,24 @@ msgstr "" "uvolnit z paměti." #. (itstool) path: listitem/para -#: C/index.docbook:1542 +#: C/index.docbook:1548 msgid "Document whether parameters can be NULL, and what happens if they are." msgstr "" "Zdokumentovat, jestli může parametr být NULL a co se stane, když tomu tak je." #. (itstool) path: listitem/para -#: C/index.docbook:1547 +#: C/index.docbook:1553 msgid "" "Mention interesting pre-conditions and post-conditions where appropriate." msgstr "Kde je to vhodné, zmínit úvodní a koncové podmínky." #. (itstool) path: sect2/para -#: C/index.docbook:1532 C/index.docbook:1618 +#: C/index.docbook:1538 C/index.docbook:1624 msgid "Please remember to: <_:itemizedlist-1/>" msgstr "Nezapomeňte prosím: <_:itemizedlist-1/>" #. (itstool) path: sect2/para -#: C/index.docbook:1554 +#: C/index.docbook:1560 msgid "" "Gtk-doc assumes all symbols (macros, functions) starting with '_' are " "private. They are treated like static functions." @@ -2461,7 +2470,7 @@ msgstr "" "„_“, jsou soukromé. Potom se s nimi zachází jako se statickými funkcemi." #. (itstool) path: example/programlisting -#: C/index.docbook:1560 +#: C/index.docbook:1566 #, no-wrap msgid "" "\n" @@ -2503,27 +2512,27 @@ msgstr "" " */\n" #. (itstool) path: variablelist/title -#: C/index.docbook:1581 +#: C/index.docbook:1587 msgid "Function tags" msgstr "Značky pro funkce" #. (itstool) path: varlistentry/term -#: C/index.docbook:1582 C/index.docbook:1789 +#: C/index.docbook:1588 C/index.docbook:1795 msgid "Returns:" msgstr "Returns:" #. (itstool) path: listitem/para -#: C/index.docbook:1584 +#: C/index.docbook:1590 msgid "Paragraph describing the returned result." msgstr "Odstavec popisující vracený výsledek." #. (itstool) path: varlistentry/term -#: C/index.docbook:1589 +#: C/index.docbook:1595 msgid "@...:" msgstr "@…:" #. (itstool) path: listitem/para -#: C/index.docbook:1591 +#: C/index.docbook:1597 msgid "" "In case the function has variadic arguments, you should use this tag " "(@Varargs: does also work for historic reasons)." @@ -2533,12 +2542,12 @@ msgstr "" #. (itstool) path: sect2/title #. (itstool) path: example/title -#: C/index.docbook:1601 C/index.docbook:1603 +#: C/index.docbook:1607 C/index.docbook:1609 msgid "Property comment block" msgstr "Komentářový blok pro vlastnost" #. (itstool) path: example/programlisting -#: C/index.docbook:1604 +#: C/index.docbook:1610 #, no-wrap msgid "" "\n" @@ -2559,12 +2568,12 @@ msgstr "" #. (itstool) path: sect2/title #. (itstool) path: example/title -#: C/index.docbook:1616 C/index.docbook:1635 +#: C/index.docbook:1622 C/index.docbook:1641 msgid "Signal comment block" msgstr "Komentářový blok pro signál" #. (itstool) path: listitem/para -#: C/index.docbook:1622 +#: C/index.docbook:1628 msgid "" "Document when the signal is emitted and whether it is emitted before or " "after other signals." @@ -2573,12 +2582,12 @@ msgstr "" "ostatních signálech." #. (itstool) path: listitem/para -#: C/index.docbook:1628 +#: C/index.docbook:1634 msgid "Document what an application might do in the signal handler." msgstr "Zdokumentovat, co aplikace smí v obsluze signálu provádět." #. (itstool) path: example/programlisting -#: C/index.docbook:1636 +#: C/index.docbook:1642 #, no-wrap msgid "" "\n" @@ -2609,12 +2618,12 @@ msgstr "" #. (itstool) path: sect2/title #. (itstool) path: example/title -#: C/index.docbook:1653 C/index.docbook:1654 +#: C/index.docbook:1659 C/index.docbook:1660 msgid "Struct comment block" msgstr "Komentářový blok pro strukturu" #. (itstool) path: example/programlisting -#: C/index.docbook:1655 +#: C/index.docbook:1661 #, no-wrap msgid "" "\n" @@ -2644,7 +2653,7 @@ msgstr "" "} FooWidget;\n" #. (itstool) path: sect2/para -#: C/index.docbook:1670 +#: C/index.docbook:1676 msgid "" "Use <code>/*< private >*/</code> before the private struct fields you " "want to hide. Use <code>/*< public >*/</code> for the reverse " @@ -2655,7 +2664,7 @@ msgstr "" "*/</code>." #. (itstool) path: sect2/para -#: C/index.docbook:1676 +#: C/index.docbook:1682 msgid "" "If the first field is \"g_iface\", \"parent_instance\" or \"parent_class\" " "it will be considered private automatically and doesn't need to be mentioned " @@ -2666,7 +2675,7 @@ msgstr "" "komentářovém bloku." #. (itstool) path: sect2/para -#: C/index.docbook:1682 +#: C/index.docbook:1688 msgid "" "Struct comment blocks can also be used for GObjects and GObjectClasses. It " "is usually a good idea to add a comment block for a class, if it has " @@ -2686,12 +2695,12 @@ msgstr "" #. (itstool) path: sect2/title #. (itstool) path: example/title -#: C/index.docbook:1694 C/index.docbook:1695 +#: C/index.docbook:1700 C/index.docbook:1701 msgid "Enum comment block" msgstr "Komentářový blok pro výčty" #. (itstool) path: example/programlisting -#: C/index.docbook:1696 +#: C/index.docbook:1702 #, no-wrap msgid "" "\n" @@ -2725,7 +2734,7 @@ msgstr "" "} Something;\n" #. (itstool) path: sect2/para -#: C/index.docbook:1713 +#: C/index.docbook:1719 msgid "" "Use <code>/*< private >*/</code> before the private enum values you " "want to hide. Use <code>/*< public >*/</code> for the reverse " @@ -2736,12 +2745,12 @@ msgstr "" "public >*/</code>." #. (itstool) path: sect1/title -#: C/index.docbook:1724 +#: C/index.docbook:1730 msgid "Inline program documentation" msgstr "Dokumentaci k vloženým programům" #. (itstool) path: sect1/para -#: C/index.docbook:1725 +#: C/index.docbook:1731 msgid "" "You can document programs and their commandline interface using inline " "documentation." @@ -2750,37 +2759,37 @@ msgstr "" "vložené dokumentace." #. (itstool) path: variablelist/title -#: C/index.docbook:1731 +#: C/index.docbook:1737 msgid "Tags" msgstr "Značky" #. (itstool) path: varlistentry/term -#: C/index.docbook:1733 +#: C/index.docbook:1739 msgid "PROGRAM" msgstr "PROGRAM" #. (itstool) path: listitem/para -#: C/index.docbook:1736 +#: C/index.docbook:1742 msgid "Defines the start of a program documentation." msgstr "Definuje začátek dokumentace k programu." #. (itstool) path: varlistentry/term -#: C/index.docbook:1743 +#: C/index.docbook:1749 msgid "@short_description:" msgstr "@short_description:" #. (itstool) path: listitem/para -#: C/index.docbook:1745 +#: C/index.docbook:1751 msgid "Defines a short description of the program. (Optional)" msgstr "Definuje krátký popis programu. (volitelné)" #. (itstool) path: varlistentry/term -#: C/index.docbook:1752 +#: C/index.docbook:1758 msgid "@synopsis:" msgstr "@synopsis:" #. (itstool) path: listitem/para -#: C/index.docbook:1754 +#: C/index.docbook:1760 msgid "" "Defines the arguments, or list of arguments that the program can take. " "(Optional)" @@ -2788,52 +2797,52 @@ msgstr "" "Definuje argumenty nebo seznam argumentů, které program přebírá. (volitelné)" #. (itstool) path: varlistentry/term -#: C/index.docbook:1762 +#: C/index.docbook:1768 msgid "@see_also:" msgstr "@see_also:" #. (itstool) path: listitem/para -#: C/index.docbook:1764 +#: C/index.docbook:1770 msgid "See Also manual page section. (Optional)" msgstr "Část stránky oddílu „Viz také“. (volitelné)" #. (itstool) path: varlistentry/term -#: C/index.docbook:1771 +#: C/index.docbook:1777 msgid "@arg:" msgstr "@arg:" #. (itstool) path: listitem/para -#: C/index.docbook:1773 +#: C/index.docbook:1779 msgid "Argument(s) passed to the program and their description. (Optional)" msgstr "Argument(y) předávané do programu a jejich popis. (volitelné)" #. (itstool) path: varlistentry/term -#: C/index.docbook:1780 +#: C/index.docbook:1786 msgid "Description:" msgstr "Description:" #. (itstool) path: listitem/para -#: C/index.docbook:1782 +#: C/index.docbook:1788 msgid "A longer description of the program." msgstr "Úplný popis programu." #. (itstool) path: listitem/para -#: C/index.docbook:1791 +#: C/index.docbook:1797 msgid "Specify what value(s) the program returns. (Optional)" msgstr "Specifikuje, jakou hodnotu či více hodnot program vrací. (volitelné)" #. (itstool) path: sect2/title -#: C/index.docbook:1800 +#: C/index.docbook:1806 msgid "Example of program documentation." msgstr "Příklad dokumentace k programu." #. (itstool) path: example/title -#: C/index.docbook:1801 +#: C/index.docbook:1807 msgid "Program documentation block" msgstr "Komentářový blok pro program" #. (itstool) path: example/programlisting -#: C/index.docbook:1802 +#: C/index.docbook:1808 #, no-wrap msgid "" "\n" @@ -2877,12 +2886,12 @@ msgstr "" "}\n" #. (itstool) path: sect1/title -#: C/index.docbook:1828 +#: C/index.docbook:1834 msgid "Useful DocBook tags" msgstr "Užitečné značky DocBook" #. (itstool) path: sect1/para -#: C/index.docbook:1830 +#: C/index.docbook:1836 msgid "" "Here are some DocBook tags which are most useful when documenting the code." msgstr "" @@ -2890,7 +2899,7 @@ msgstr "" "význam." #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1839 +#: C/index.docbook:1845 #, no-wrap msgid "" "\n" @@ -2900,7 +2909,7 @@ msgstr "" "<link linkend=\"glib-Hash-Tables\">Hašovací tabulky</link>\n" #. (itstool) path: sect1/para -#: C/index.docbook:1835 +#: C/index.docbook:1841 msgid "" "To link to another section in the GTK docs: <_:informalexample-1/> The " "linkend is the SGML/XML id on the top item of the page you want to link to. " @@ -2915,7 +2924,7 @@ msgstr "" "podtržítka se převedou na „-“, aby to vyhovovalo SGML/XML." #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1852 +#: C/index.docbook:1858 #, no-wrap msgid "" "\n" @@ -2925,7 +2934,7 @@ msgstr "" "<function>…</function>\n" #. (itstool) path: sect1/para -#: C/index.docbook:1849 +#: C/index.docbook:1855 msgid "" "To refer to an external function, e.g. a standard C function: <_:" "informalexample-1/>" @@ -2934,7 +2943,7 @@ msgstr "" ">" #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1861 +#: C/index.docbook:1867 #, no-wrap msgid "" "\n" @@ -2954,7 +2963,7 @@ msgstr "" "</example>\n" #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1872 +#: C/index.docbook:1878 #, no-wrap msgid "" "\n" @@ -2972,7 +2981,7 @@ msgstr "" "</informalexample>\n" #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1884 +#: C/index.docbook:1890 #, no-wrap msgid "" "\n" @@ -2986,7 +2995,7 @@ msgstr "" "]|\n" #. (itstool) path: sect1/para -#: C/index.docbook:1858 +#: C/index.docbook:1864 msgid "" "To include example code: <_:informalexample-1/> or possibly this, for very " "short code fragments which don't need a title: <_:informalexample-2/> In " @@ -2998,11 +3007,11 @@ msgstr "" "kódu, které nepotřebují nadpisy, je případně možné i: <_:informalexample-2/> " "V obou případech je atribut language volitelnáý a je používán jako rada pro " "program provádějící zvýrazňování syntaxe (pygments pro výstup v html).V " -"novějších verzích GTK-Doc je také podporované zkracování: " -"<_:informalexample-3/>" +"novějších verzích GTK-Doc je také podporované zkracování: <_:" +"informalexample-3/>" #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1895 +#: C/index.docbook:1901 #, no-wrap msgid "" "\n" @@ -3034,12 +3043,12 @@ msgstr "" "</itemizedlist>\n" #. (itstool) path: sect1/para -#: C/index.docbook:1892 +#: C/index.docbook:1898 msgid "To include bulleted lists: <_:informalexample-1/>" msgstr "Vložení seznamu s odrážkami: <_:informalexample-1/>" #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1915 +#: C/index.docbook:1921 #, no-wrap msgid "" "\n" @@ -3057,13 +3066,13 @@ msgstr "" "</note>\n" #. (itstool) path: sect1/para -#: C/index.docbook:1912 +#: C/index.docbook:1918 msgid "" "To include a note which stands out from the text: <_:informalexample-1/>" msgstr "Vložení poznámky, která se objeví mimo text: <_:informalexample-1/>" #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1928 +#: C/index.docbook:1934 #, no-wrap msgid "" "\n" @@ -3073,12 +3082,12 @@ msgstr "" "<type>unsigned char</type>\n" #. (itstool) path: sect1/para -#: C/index.docbook:1925 +#: C/index.docbook:1931 msgid "To refer to a type: <_:informalexample-1/>" msgstr "Odkaz na typ: <_:informalexample-1/>" #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1937 +#: C/index.docbook:1943 #, no-wrap msgid "" "\n" @@ -3088,7 +3097,7 @@ msgstr "" "<structname>XFontStruct</structname>\n" #. (itstool) path: sect1/para -#: C/index.docbook:1934 +#: C/index.docbook:1940 msgid "" "To refer to an external structure (not one described in the GTK docs): <_:" "informalexample-1/>" @@ -3097,7 +3106,7 @@ msgstr "" "informalexample-1/>" #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1946 +#: C/index.docbook:1952 #, no-wrap msgid "" "\n" @@ -3107,12 +3116,12 @@ msgstr "" "<structfield>len</structfield>\n" #. (itstool) path: sect1/para -#: C/index.docbook:1943 +#: C/index.docbook:1949 msgid "To refer to a field of a structure: <_:informalexample-1/>" msgstr "Odkaz na pole struktury: <_:informalexample-1/>" #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1955 +#: C/index.docbook:1961 #, no-wrap msgid "" "\n" @@ -3122,7 +3131,7 @@ msgstr "" "<classname>GtkWidget</classname>\n" #. (itstool) path: sect1/para -#: C/index.docbook:1952 +#: C/index.docbook:1958 msgid "" "To refer to a class name, we could possibly use: <_:informalexample-1/> but " "you'll probably be using #GtkWidget instead (to automatically create a link " @@ -3135,7 +3144,7 @@ msgstr "" "\"documenting_syntax\">zkratky</link>)." #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1966 +#: C/index.docbook:1972 #, no-wrap msgid "" "\n" @@ -3145,12 +3154,12 @@ msgstr "" "<emphasis>Toto je důležité</emphasis>\n" #. (itstool) path: sect1/para -#: C/index.docbook:1963 +#: C/index.docbook:1969 msgid "To emphasize text: <_:informalexample-1/>" msgstr "Zvýrazněný text: <_:informalexample-1/>" #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1975 +#: C/index.docbook:1981 #, no-wrap msgid "" "\n" @@ -3160,12 +3169,12 @@ msgstr "" "<filename>/home/user/documents</filename>\n" #. (itstool) path: sect1/para -#: C/index.docbook:1972 +#: C/index.docbook:1978 msgid "For filenames use: <_:informalexample-1/>" msgstr "Pro název souboru použijte: <_:informalexample-1/>" #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1984 +#: C/index.docbook:1990 #, no-wrap msgid "" "\n" @@ -3175,17 +3184,17 @@ msgstr "" "<keycombo><keycap>Ctrl</keycap><keycap>L</keycap></keycombo>\n" #. (itstool) path: sect1/para -#: C/index.docbook:1981 +#: C/index.docbook:1987 msgid "To refer to keys use: <_:informalexample-1/>" msgstr "Odkaz na použití klávesy: <_:informalexample-1/>" #. (itstool) path: chapter/title -#: C/index.docbook:1994 +#: C/index.docbook:2000 msgid "Filling the extra files" msgstr "Vyplňování dodatečných souborů" #. (itstool) path: chapter/para -#: C/index.docbook:1996 +#: C/index.docbook:2002 msgid "" "There are a couple of extra files, that need to be maintained along with the " "inline source code comments: <filename><package>.types</filename>, " @@ -3198,12 +3207,12 @@ msgstr "" "<filename><balíček>-sections.txt</filename>." #. (itstool) path: sect1/title -#: C/index.docbook:2005 +#: C/index.docbook:2011 msgid "Editing the types file" msgstr "Úprava souboru s typy" #. (itstool) path: sect1/para -#: C/index.docbook:2007 +#: C/index.docbook:2013 msgid "" "If your library or application includes GObjects, you want their signals, " "arguments/parameters and position in the hierarchy to be shown in the " @@ -3218,12 +3227,12 @@ msgstr "" "filename>." #. (itstool) path: example/title -#: C/index.docbook:2016 +#: C/index.docbook:2022 msgid "Example <package>.types file" msgstr "Příklad souboru <balíček>.types" #. (itstool) path: example/programlisting -#: C/index.docbook:2017 +#: C/index.docbook:2023 #, no-wrap msgid "" "\n" @@ -3243,7 +3252,7 @@ msgstr "" "gtk_arrow_get_type\n" #. (itstool) path: sect1/para -#: C/index.docbook:2028 +#: C/index.docbook:2034 msgid "" "Since GTK-Doc 1.8 <application>gtkdoc-scan</application> can generate this " "list for you. Just add \"--rebuild-types\" to SCAN_OPTIONS in " @@ -3256,12 +3265,12 @@ msgstr "" "byste soubor s typy šířit do správy verzí." #. (itstool) path: sect1/title -#: C/index.docbook:2037 +#: C/index.docbook:2043 msgid "Editing the master document" msgstr "Úprava hlavního dokumentu" #. (itstool) path: sect1/para -#: C/index.docbook:2039 +#: C/index.docbook:2045 msgid "" "GTK-Doc produces documentation in DocBook SGML/XML. When processing the " "inline source comments, the GTK-Doc tools generate one documentation page " @@ -3274,7 +3283,7 @@ msgstr "" "soubor. Všechny jsou pak uvedené seřazené v hlavním dokumentu." #. (itstool) path: sect1/para -#: C/index.docbook:2046 +#: C/index.docbook:2052 msgid "" "While GTK-Doc creates a template master document for you, later runs will " "not touch it again. This means that one can freely structure the " @@ -3291,7 +3300,7 @@ msgstr "" "nahlédnout, jestli se v něm neobjevily nějaké nové věci." #. (itstool) path: tip/para -#: C/index.docbook:2056 +#: C/index.docbook:2062 msgid "" "Do not create tutorials as extra documents. Just write extra chapters. The " "benefit of directly embedding the tutorial for your library into the API " @@ -3306,7 +3315,7 @@ msgstr "" "v knihovně." #. (itstool) path: sect1/para -#: C/index.docbook:2065 +#: C/index.docbook:2071 msgid "" "So what are the things to change inside the master document? For a start is " "only a little. There are some placeholders (text in square brackets) there " @@ -3317,12 +3326,12 @@ msgstr "" "závorkách), o které byste se měli postarat." #. (itstool) path: example/title -#: C/index.docbook:2072 +#: C/index.docbook:2078 msgid "Master document header" msgstr "Hlavička hlavního dokumentu" #. (itstool) path: example/programlisting -#: C/index.docbook:2073 +#: C/index.docbook:2079 #, no-wrap msgid "" "\n" @@ -3352,7 +3361,7 @@ msgstr "" " <title>[Insert title here]</title>\n" #. (itstool) path: sect1/para -#: C/index.docbook:2089 +#: C/index.docbook:2095 msgid "" "In addition a few option elements are created in commented form. You can " "review these and enable them as you like." @@ -3361,12 +3370,12 @@ msgstr "" "projít a případně povolit." #. (itstool) path: example/title -#: C/index.docbook:2095 +#: C/index.docbook:2101 msgid "Optional part in the master document" msgstr "Volitelná část hlavního dokumentu" #. (itstool) path: example/programlisting -#: C/index.docbook:2096 +#: C/index.docbook:2102 #, no-wrap msgid "" "\n" @@ -3380,7 +3389,7 @@ msgstr "" " -->\n" #. (itstool) path: sect1/para -#: C/index.docbook:2104 +#: C/index.docbook:2110 msgid "" "Finally you need to add new section whenever you introduce one. The <link " "linkend=\"modernizing-gtk-doc-1-16\">gtkdoc-check</link> tool will remind " @@ -3391,12 +3400,12 @@ msgstr "" "vygenerované soubory XML, které zatím nejsou v dokumentaci zahrnuté." #. (itstool) path: example/title -#: C/index.docbook:2112 C/index.docbook:2147 +#: C/index.docbook:2118 C/index.docbook:2153 msgid "Including generated sections" msgstr "Vkládání generovaných oddílů" #. (itstool) path: example/programlisting -#: C/index.docbook:2113 +#: C/index.docbook:2119 #, no-wrap msgid "" "\n" @@ -3412,12 +3421,12 @@ msgstr "" " …\n" #. (itstool) path: sect1/title -#: C/index.docbook:2125 +#: C/index.docbook:2131 msgid "Editing the section file" msgstr "Úprava souboru oddílů" #. (itstool) path: sect1/para -#: C/index.docbook:2127 +#: C/index.docbook:2133 msgid "" "The section file is used to organise the documentation output by GTK-Doc. " "Here one specifies which symbol belongs to which module or class and control " @@ -3428,7 +3437,7 @@ msgstr "" "viditelnost (jestli je veřejný nebo soukromý)." #. (itstool) path: sect1/para -#: C/index.docbook:2133 +#: C/index.docbook:2139 msgid "" "The section file is a plain text file with tags delimiting sections. Blank " "lines are ignored and lines starting with a '#' are treated as comment lines." @@ -3438,7 +3447,7 @@ msgstr "" "jako s komentářovými řádky." #. (itstool) path: note/para -#: C/index.docbook:2140 +#: C/index.docbook:2146 msgid "" "While the tags make the file look like xml, it is not. Please do not close " "tags like <SUBSECTION>." @@ -3447,7 +3456,7 @@ msgstr "" "Neuzavírejte prosím značky jako je <SUBSECTION>." #. (itstool) path: example/programlisting -#: C/index.docbook:2148 +#: C/index.docbook:2154 #, no-wrap msgid "" "\n" @@ -3479,7 +3488,7 @@ msgstr "" "</SECTION>\n" #. (itstool) path: sect1/para -#: C/index.docbook:2165 +#: C/index.docbook:2171 msgid "" "The <FILE> ... </FILE> tag is used to specify the file name, " "without any suffix. For example, using '<FILE>gnome-config</" @@ -3501,7 +3510,7 @@ msgstr "" "názvu třídy GObject převedeného na malá písmena.)" #. (itstool) path: sect1/para -#: C/index.docbook:2177 +#: C/index.docbook:2183 msgid "" "The <TITLE> ... </TITLE> tag is used to specify the title of the " "section. It is only useful before the templates (if used) are initially " @@ -3515,7 +3524,7 @@ msgstr "" "zdrojovém kódu." #. (itstool) path: sect1/para -#: C/index.docbook:2184 +#: C/index.docbook:2190 msgid "" "You can group items in the section by using the <SUBSECTION> tag. " "Currently it outputs a blank line between subsections in the synopsis " @@ -3545,7 +3554,7 @@ msgstr "" "virtuální metody)." #. (itstool) path: sect1/para -#: C/index.docbook:2203 +#: C/index.docbook:2209 msgid "" "You can also use <INCLUDE> ... </INCLUDE> to specify the " "#include files which are shown in the synopsis sections. It contains a comma-" @@ -3560,12 +3569,12 @@ msgstr "" "konce souboru. Když je nastavíte v konkrétním oddílu, použijí se jen pro něj." #. (itstool) path: chapter/title -#: C/index.docbook:2217 +#: C/index.docbook:2223 msgid "Controlling the result" msgstr "Ovlivnění výsledku" #. (itstool) path: chapter/para -#: C/index.docbook:2219 +#: C/index.docbook:2225 msgid "" "A GTK-Doc run generates report files inside the documentation directory. The " "generated files are named: <filename><package>-undocumented.txt</" @@ -3580,7 +3589,7 @@ msgstr "" "prosté textové soubory, které si lze jednoduše prohlížet a zpracovávat je." #. (itstool) path: chapter/para -#: C/index.docbook:2228 +#: C/index.docbook:2234 msgid "" "The <filename><package>-undocumented.txt</filename> file starts with " "the documentation coverage summary. Below are two sections divided by blank " @@ -3596,7 +3605,7 @@ msgstr "" "parametr." #. (itstool) path: chapter/para -#: C/index.docbook:2237 +#: C/index.docbook:2243 msgid "" "The <filename><package>-undeclared.txt</filename> file lists symbols " "given in the <filename><package>-sections.txt</filename> but not found " @@ -3608,7 +3617,7 @@ msgstr "" "v nich není překlep." #. (itstool) path: chapter/para -#: C/index.docbook:2244 +#: C/index.docbook:2250 msgid "" "The <filename><package>-unused.txt</filename> file lists symbol names, " "where the GTK-Doc scanner has found documentation, but does not know where " @@ -3621,7 +3630,7 @@ msgstr "" "balíček>-section.txt</filename>." #. (itstool) path: tip/para -#: C/index.docbook:2252 +#: C/index.docbook:2258 msgid "" "Enable or add the <option>TESTS=$(GTKDOC_CHECK)</option> line in Makefile." "am. If at least GTK-Doc 1.9 is installed, this will run sanity checks during " @@ -3633,7 +3642,7 @@ msgstr "" "správnosti údajů." #. (itstool) path: chapter/para -#: C/index.docbook:2259 +#: C/index.docbook:2265 msgid "" "One can also look at the files produced by the source code scanner: " "<filename><package>-decl-list.txt</filename> and <filename><" @@ -3650,7 +3659,7 @@ msgstr "" "zkontrolovat, jestli se vyskytuje v tomto souboru." #. (itstool) path: chapter/para -#: C/index.docbook:2268 +#: C/index.docbook:2274 msgid "" "If the project is GObject based, one can also look into the files produced " "by the object scanner: <filename><package>.args.txt</filename>, " @@ -3671,12 +3680,12 @@ msgstr "" "Doc, aby přechodně zachovat soubor pro pozdější analýzu." #. (itstool) path: chapter/title -#: C/index.docbook:2283 +#: C/index.docbook:2289 msgid "Modernizing the documentation" msgstr "Modernizace dokumentu" #. (itstool) path: chapter/para -#: C/index.docbook:2285 +#: C/index.docbook:2291 msgid "" "GTK-Doc has been around for quite some time. In this section we list new " "features together with the version since when it is available." @@ -3685,12 +3694,12 @@ msgstr "" "funkcí spolu s číslem verze, od které je tato funkčnost k dispozici." #. (itstool) path: sect1/title -#: C/index.docbook:2291 +#: C/index.docbook:2297 msgid "GTK-Doc 1.9" msgstr "GTK-Doc 1.9" #. (itstool) path: sect1/para -#: C/index.docbook:2293 +#: C/index.docbook:2299 msgid "" "When using xml instead of sgml, one can actually name the master document " "<filename><package>-docs.xml</filename>." @@ -3699,7 +3708,7 @@ msgstr "" "dokument <filename><package>-docs.xml</filename>." #. (itstool) path: sect1/para -#: C/index.docbook:2298 +#: C/index.docbook:2304 msgid "" "This version supports <option>SCAN_OPTIONS=--rebuild-sections</option> in " "<filename>Makefile.am</filename>. When this is enabled, the <filename><" @@ -3720,7 +3729,7 @@ msgstr "" "<code>meld <package>-decl-list.txt <package>-sections.txt</code>." #. (itstool) path: sect1/para -#: C/index.docbook:2309 +#: C/index.docbook:2315 msgid "" "Version 1.8 already introduced the syntax for documenting sections in the " "sources instead of the separate files under <filename class=\"directory" @@ -3741,12 +3750,12 @@ msgstr "" "tuto volbu do <filename>configure.ac</filename> a je to." #. (itstool) path: sect1/title -#: C/index.docbook:2321 +#: C/index.docbook:2327 msgid "GTK-Doc 1.10" msgstr "GTK-Doc 1.10" #. (itstool) path: sect1/para -#: C/index.docbook:2323 +#: C/index.docbook:2329 msgid "" "This version supports <option>SCAN_OPTIONS=--rebuild-types</option> in " "<filename>Makefile.am</filename>. When this is enabled, the <filename><" @@ -3763,17 +3772,17 @@ msgstr "" "filename> pro kód, který je sestavován podmíněně." #. (itstool) path: sect1/title -#: C/index.docbook:2334 +#: C/index.docbook:2340 msgid "GTK-Doc 1.16" msgstr "GTK-Doc 1.16" #. (itstool) path: example/title -#: C/index.docbook:2340 +#: C/index.docbook:2346 msgid "Enable gtkdoc-check" msgstr "Povolení gtkdoc-check" #. (itstool) path: example/programlisting -#: C/index.docbook:2341 +#: C/index.docbook:2347 #, no-wrap msgid "" "\n" @@ -3793,7 +3802,7 @@ msgstr "" "endif\n" #. (itstool) path: sect1/para -#: C/index.docbook:2336 +#: C/index.docbook:2342 msgid "" "This version includes a new tool called gtkdoc-check. This tool can run a " "set of sanity checks on your documentation. It is enabled by adding these " @@ -3805,12 +3814,12 @@ msgstr "" ">" #. (itstool) path: sect1/title -#: C/index.docbook:2354 +#: C/index.docbook:2360 msgid "GTK-Doc 1.20" msgstr "GTK-Doc 1.20" #. (itstool) path: sect1/para -#: C/index.docbook:2356 +#: C/index.docbook:2362 msgid "" "Version 1.18 brought some initial markdown support. Using markdown in doc " "comments is less intrusive than writing docbook xml. This version improves a " @@ -3824,17 +3833,17 @@ msgstr "" "\"documenting_syntax\">syntax komentářů</link>." #. (itstool) path: sect1/title -#: C/index.docbook:2366 +#: C/index.docbook:2372 msgid "GTK-Doc 1.25" msgstr "GTK-Doc 1.25" #. (itstool) path: example/title -#: C/index.docbook:2377 +#: C/index.docbook:2383 msgid "Use pre-generated entities" msgstr "Používání předgenerovaných entit" #. (itstool) path: example/programlisting -#: C/index.docbook:2378 +#: C/index.docbook:2384 #, no-wrap msgid "" "\n" @@ -3876,7 +3885,7 @@ msgstr "" " </bookinfo>\n" #. (itstool) path: sect1/para -#: C/index.docbook:2368 +#: C/index.docbook:2374 msgid "" "The makefiles shipped with this version generate an entity file at " "<filename>xml/gtkdocentities.ent</filename>, containing entities for e.g. " @@ -3896,12 +3905,12 @@ msgstr "" "example-1/>" #. (itstool) path: chapter/title -#: C/index.docbook:2403 +#: C/index.docbook:2409 msgid "Documenting other interfaces" msgstr "Dokumentování ostatních rozhraní" #. (itstool) path: chapter/para -#: C/index.docbook:2405 +#: C/index.docbook:2411 msgid "" "So far we have been using GTK-Doc to document the API of code. The next " "sections contain suggestions how the tools can be used to document other " @@ -3912,12 +3921,12 @@ msgstr "" "dalších rozhraní." #. (itstool) path: sect1/title -#: C/index.docbook:2412 +#: C/index.docbook:2418 msgid "Command line options and man pages" msgstr "Přepínače příkazového řádku a manuálové stránky" #. (itstool) path: sect1/para -#: C/index.docbook:2414 +#: C/index.docbook:2420 msgid "" "As one can generate man pages for a docbook refentry as well, it sounds like " "a good idea to use it for that purpose. This way the interface is part of " @@ -3929,12 +3938,12 @@ msgstr "" "manuálovou stránku." #. (itstool) path: sect2/title -#: C/index.docbook:2421 +#: C/index.docbook:2427 msgid "Document the tool" msgstr "Dokumentování nástrojů" #. (itstool) path: sect2/para -#: C/index.docbook:2423 +#: C/index.docbook:2429 msgid "" "Create one refentry file per tool. Following <link linkend=" "\"settingup_docfiles\">our example</link> we would call it <filename>meep/" @@ -3949,17 +3958,17 @@ msgstr "" "souboru v podsložce XML, například v glib." #. (itstool) path: sect2/title -#: C/index.docbook:2433 +#: C/index.docbook:2439 msgid "Adding the extra configure check" msgstr "Přidání doplňkových kontrol do configure" #. (itstool) path: example/title -#: C/index.docbook:2436 C/index.docbook:2454 +#: C/index.docbook:2442 C/index.docbook:2460 msgid "Extra configure checks" msgstr "Dodatečné kontroly nastavení" #. (itstool) path: example/programlisting -#: C/index.docbook:2437 +#: C/index.docbook:2443 #, no-wrap msgid "" "\n" @@ -3981,12 +3990,12 @@ msgstr "" "AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n" #. (itstool) path: sect2/title -#: C/index.docbook:2451 +#: C/index.docbook:2457 msgid "Adding the extra makefile rules" msgstr "Přidání doplňkových pravidel do Makefile" #. (itstool) path: example/programlisting -#: C/index.docbook:2455 +#: C/index.docbook:2461 #, no-wrap msgid "" "\n" @@ -4022,12 +4031,12 @@ msgstr "" "EXTRA_DIST += meep.xml\n" #. (itstool) path: sect1/title -#: C/index.docbook:2477 +#: C/index.docbook:2483 msgid "DBus interfaces" msgstr "Rozhraní D-Bus" #. (itstool) path: sect1/para -#: C/index.docbook:2479 +#: C/index.docbook:2485 msgid "" "(FIXME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://" "cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)" @@ -4036,27 +4045,27 @@ msgstr "" "cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)" #. (itstool) path: chapter/title -#: C/index.docbook:2488 +#: C/index.docbook:2494 msgid "Frequently asked questions" msgstr "Často kladené dotazy" #. (itstool) path: segmentedlist/segtitle -#: C/index.docbook:2492 +#: C/index.docbook:2498 msgid "Question" msgstr "Dotaz" #. (itstool) path: segmentedlist/segtitle -#: C/index.docbook:2493 +#: C/index.docbook:2499 msgid "Answer" msgstr "Odpověď" #. (itstool) path: seglistitem/seg -#: C/index.docbook:2495 +#: C/index.docbook:2501 msgid "No class hierarchy." msgstr "Schází hierarchie třídy." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2496 +#: C/index.docbook:2502 msgid "" "The objects <function>xxx_get_type()</function> function has not been " "entered into the <filename><package>.types</filename> file." @@ -4065,12 +4074,12 @@ msgstr "" "objektu <function>xxx_get_type()</function>." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2502 +#: C/index.docbook:2508 msgid "Still no class hierarchy." msgstr "Stále schází hierarchie třídy." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2503 +#: C/index.docbook:2509 msgid "" "Missing or wrong naming in <filename><package>-sections.txt</filename> " "file (see <ulink url=\"http://mail.gnome.org/archives/gtk-doc-list/2003-" @@ -4081,12 +4090,12 @@ msgstr "" "doc-list/2003-October/msg00006.html\">vysvětlení</ulink>)." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2509 +#: C/index.docbook:2515 msgid "Damn, I have still no class hierarchy." msgstr "Do háje, pořád nemám hierarchii třídy." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2510 +#: C/index.docbook:2516 msgid "" "Is the object name (name of the instance struct, e.g. <type>GtkWidget</" "type>) part of the normal section (don't put this into Standard or Private " @@ -4097,12 +4106,12 @@ msgstr "" "Private)." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2517 +#: C/index.docbook:2523 msgid "No symbol index." msgstr "Chybí rejstřík symbolů." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2518 +#: C/index.docbook:2524 msgid "" "Does the <filename><package>-docs.{xml,sgml}</filename> contain a " "index that xi:includes the generated index?" @@ -4111,12 +4120,12 @@ msgstr "" "který vloží pomocí xi:include vygenerovaný rejstřík?" #. (itstool) path: seglistitem/seg -#: C/index.docbook:2524 +#: C/index.docbook:2530 msgid "Symbols are not linked to their doc-section." msgstr "Symbol nemá odkaz do svého oddílu dokumentace." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2525 +#: C/index.docbook:2531 msgid "" "Is the doc-comment using the correct markup (added #,% or ())? Check if the " "gtkdoc-fixxref warns about unresolvable xrefs." @@ -4125,12 +4134,12 @@ msgstr "" "Podívejte se na varování gtkdoc-fixxref o nevyřešených křížových odkazech." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2531 +#: C/index.docbook:2537 msgid "A new class does not appear in the docs." msgstr "Nová třída se neobjevila v dokumentaci." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2532 +#: C/index.docbook:2538 msgid "" "Is the new page xi:included from <filename><package>-docs.{xml,sgml}</" "filename>." @@ -4139,12 +4148,12 @@ msgstr "" "{xml,sgml}</filename>." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2538 +#: C/index.docbook:2544 msgid "A new symbol does not appear in the docs." msgstr "Nový symbol se neobjevil v dokumentaci." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2539 +#: C/index.docbook:2545 msgid "" "Is the doc-comment properly formatted. Check for spelling mistakes in the " "begin of the comment. Check if the gtkdoc-fixxref warns about unresolvable " @@ -4157,12 +4166,12 @@ msgstr "" "<filename><package>-sections.txt</filename> ve veřejném pododdíle." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2547 +#: C/index.docbook:2553 msgid "A type is missing from the class hierarchy." msgstr "V hierarchii třídy schází typ." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2548 +#: C/index.docbook:2554 msgid "" "If the type is listed in <filename><package>.hierarchy</filename> but " "not in <filename>xml/tree_index.sgml</filename> then double check that the " @@ -4178,13 +4187,13 @@ msgstr "" "zobrazena." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2557 +#: C/index.docbook:2563 msgid "I get foldoc links for all gobject annotations." msgstr "" "Vytvořily se mi odkazy na složku s dokumentací pro všechny anotace k GObject" #. (itstool) path: seglistitem/seg -#: C/index.docbook:2558 +#: C/index.docbook:2564 msgid "" "Check that <filename>xml/annotation-glossary.xml</filename> is xi:included " "from <filename><package>-docs.{xml,sgml}</filename>." @@ -4193,13 +4202,13 @@ msgstr "" "pomocí xi:include z <filename><package>-docs.{xml,sgml}</filename>." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2566 +#: C/index.docbook:2572 msgid "Parameter described in source code comment block but does not exist" msgstr "" "Parametr je v komentářovém bloku zdrojového kódu popsaný, ale neexistuje." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2567 +#: C/index.docbook:2573 msgid "" "Check if the prototype in the header has different parameter names as in the " "source." @@ -4208,12 +4217,12 @@ msgstr "" "než ve zdrojovém kódu." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2572 +#: C/index.docbook:2578 msgid "multiple \"IDs\" for constraint linkend: XYZ" msgstr "Více „ID“ pro tentýž cíl odkazu: XYZ" #. (itstool) path: seglistitem/seg -#: C/index.docbook:2573 +#: C/index.docbook:2579 msgid "" "Symbol XYZ appears twice in <filename><package>-sections.txt</" "filename> file." @@ -4222,7 +4231,7 @@ msgstr "" "objevuje dvakrát." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2576 +#: C/index.docbook:2582 msgid "" "Element typename in namespace '' encountered in para, but no template " "matches." @@ -4231,12 +4240,12 @@ msgstr "" "mu žádná šablona." #. (itstool) path: chapter/title -#: C/index.docbook:2583 +#: C/index.docbook:2589 msgid "Tools related to gtk-doc" msgstr "Nástroje související s GTK-Doc" #. (itstool) path: chapter/para -#: C/index.docbook:2585 +#: C/index.docbook:2591 msgid "" "GtkDocPlugin - a <ulink url=\"http://trac-hacks.org/wiki/GtkDocPlugin\">Trac " "GTK-Doc</ulink> integration plugin, that adds API docs to a trac site and " @@ -4247,7 +4256,7 @@ msgstr "" "dokumentaci k API na sledovací web a integruje ji do vyhledávání." #. (itstool) path: chapter/para -#: C/index.docbook:2590 +#: C/index.docbook:2596 msgid "" "Gtkdoc-depscan - a tool (part of gtk-doc) to check used API against since " "tags in the API to determine the minimum required version." diff --git a/help/manual/sv/sv.po b/help/manual/sv/sv.po index df96273..27be0e1 100644 --- a/help/manual/sv/sv.po +++ b/help/manual/sv/sv.po @@ -8,15 +8,15 @@ msgid "" msgstr "" "Project-Id-Version: gtk-doc master\n" -"POT-Creation-Date: 2019-08-15 19:15+0000\n" -"PO-Revision-Date: 2019-08-18 22:15+0200\n" +"POT-Creation-Date: 2020-10-01 20:17+0000\n" +"PO-Revision-Date: 2020-10-02 00:05+0200\n" "Last-Translator: Anders Jonsson <anders.jonsson@norsjovallen.se>\n" "Language-Team: Swedish <tp-sv@listor.tp-sv.se>\n" "Language: sv\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"X-Generator: Poedit 2.2.3\n" +"X-Generator: Poedit 2.4.1\n" #. Put one translator per line, in the form NAME <EMAIL>, YEAR1, YEAR2 msgctxt "_" @@ -91,7 +91,6 @@ msgstr "<year>2000, 2005</year> <holder>Dan Mueth and Chris Lyttle</holder>" #. (itstool) path: bookinfo/copyright #: C/index.docbook:52 -#| msgid "<year>2007-2015</year> <holder>Stefan Sauer (Kost)</holder>" msgid "<year>2007-2019</year> <holder>Stefan Sauer (Kost)</holder>" msgstr "<year>2007-2019</year> <holder>Stefan Sauer (Kost)</holder>" @@ -127,33 +126,42 @@ msgstr "" #. (itstool) path: revhistory/revision #: C/index.docbook:83 msgid "" +"<revnumber>1.33.0</revnumber> <date>1 Oct 2020</date> <authorinitials>mc</" +"authorinitials> <revremark>gtk4 version</revremark>" +msgstr "" +"<revnumber>1.33.0</revnumber> <date>1 okt 2020</date> <authorinitials>mc</" +"authorinitials> <revremark>gtk4-version</revremark>" + +#. (itstool) path: revhistory/revision +#: C/index.docbook:89 +msgid "" "<revnumber>1.32.1</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</" "authorinitials> <revremark>dev version</revremark>" msgstr "" -"<revnumber>1.32.1</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</" +"<revnumber>1.32.1</revnumber> <date>15 aug 2019</date> <authorinitials>ss</" "authorinitials> <revremark>utveckling</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:89 +#: C/index.docbook:95 msgid "" "<revnumber>1.32</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</" "authorinitials> <revremark>hotfix release</revremark>" msgstr "" -"<revnumber>1.32</revnumber> <date>15 Aug 2019</date> <authorinitials>ss</" +"<revnumber>1.32</revnumber> <date>15 aug 2019</date> <authorinitials>ss</" "authorinitials> <revremark>snabb fixutgåva</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:95 +#: C/index.docbook:101 msgid "" "<revnumber>1.31</revnumber> <date>05 Aug 2019</date> <authorinitials>ss</" "authorinitials> <revremark>refactorings and more test coverage</revremark>" msgstr "" -"<revnumber>1.31</revnumber> <date>05 Aug 2019</date> <authorinitials>ss</" +"<revnumber>1.31</revnumber> <date>05 aug 2019</date> <authorinitials>ss</" "authorinitials> <revremark>omstrukturering och större testtäckning</" "revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:101 +#: C/index.docbook:107 msgid "" "<revnumber>1.30</revnumber> <date>08 May 2019</date> <authorinitials>ss</" "authorinitials> <revremark>more test coverage</revremark>" @@ -162,16 +170,16 @@ msgstr "" "authorinitials> <revremark>större testtäckning</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:107 +#: C/index.docbook:113 msgid "" "<revnumber>1.29</revnumber> <date>28 Aug 2018</date> <authorinitials>ss</" "authorinitials> <revremark>bug fixes</revremark>" msgstr "" -"<revnumber>1.29</revnumber> <date>28 Aug 2018</date> <authorinitials>ss</" +"<revnumber>1.29</revnumber> <date>28 aug 2018</date> <authorinitials>ss</" "authorinitials> <revremark>programfixar</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:113 +#: C/index.docbook:119 msgid "" "<revnumber>1.28</revnumber> <date>24 Mar 2018</date> <authorinitials>ss</" "authorinitials> <revremark>bug fixes</revremark>" @@ -180,7 +188,7 @@ msgstr "" "authorinitials> <revremark>programfixar</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:119 +#: C/index.docbook:125 msgid "" "<revnumber>1.27</revnumber> <date>07 Dec 2017</date> <authorinitials>ss</" "authorinitials> <revremark>fine tuning of the python port</revremark>" @@ -189,7 +197,7 @@ msgstr "" "authorinitials> <revremark>finjustering av python-porteringen</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:125 +#: C/index.docbook:131 msgid "" "<revnumber>1.26</revnumber> <date>11 Aug 2017</date> <authorinitials>ss</" "authorinitials> <revremark>port all tools from perl/bash to python</" @@ -200,7 +208,7 @@ msgstr "" "revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:131 +#: C/index.docbook:137 msgid "" "<revnumber>1.25</revnumber> <date>21 March 2016</date> <authorinitials>ss</" "authorinitials> <revremark>bug fixes, test cleanups</revremark>" @@ -209,7 +217,7 @@ msgstr "" "authorinitials> <revremark>programfixar, uppstädning av tester</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:137 +#: C/index.docbook:143 msgid "" "<revnumber>1.24</revnumber> <date>29 May 2015</date> <authorinitials>ss</" "authorinitials> <revremark>bug fix</revremark>" @@ -218,7 +226,7 @@ msgstr "" "authorinitials> <revremark>programfix</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:143 +#: C/index.docbook:149 msgid "" "<revnumber>1.23</revnumber> <date>17 May 2015</date> <authorinitials>ss</" "authorinitials> <revremark>bug fix</revremark>" @@ -227,7 +235,7 @@ msgstr "" "authorinitials> <revremark>programfix</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:149 +#: C/index.docbook:155 msgid "" "<revnumber>1.22</revnumber> <date>07 May 2015</date> <authorinitials>ss</" "authorinitials> <revremark>bug fixes, dropping deprecated features</" @@ -238,7 +246,7 @@ msgstr "" "funktioner</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:155 +#: C/index.docbook:161 msgid "" "<revnumber>1.21</revnumber> <date>17 Jul 2014</date> <authorinitials>ss</" "authorinitials> <revremark>bug fixes, dropping deprecated features</" @@ -249,7 +257,7 @@ msgstr "" "funktioner</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:161 +#: C/index.docbook:167 msgid "" "<revnumber>1.20</revnumber> <date>16 Feb 2014</date> <authorinitials>ss</" "authorinitials> <revremark>bug fixes, markdown support, style improvements</" @@ -260,7 +268,7 @@ msgstr "" "stilförbättringar</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:167 +#: C/index.docbook:173 msgid "" "<revnumber>1.19</revnumber> <date>05 Jun 2013</date> <authorinitials>ss</" "authorinitials> <revremark>bug fixes</revremark>" @@ -269,7 +277,7 @@ msgstr "" "authorinitials> <revremark>programfixar</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:173 +#: C/index.docbook:179 msgid "" "<revnumber>1.18</revnumber> <date>14 Sep 2011</date> <authorinitials>ss</" "authorinitials> <revremark>bug fixes, speedups, markdown support</revremark>" @@ -279,7 +287,7 @@ msgstr "" "revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:179 +#: C/index.docbook:185 msgid "" "<revnumber>1.17</revnumber> <date>26 Feb 2011</date> <authorinitials>sk</" "authorinitials> <revremark>urgent bug fix update</revremark>" @@ -288,7 +296,7 @@ msgstr "" "authorinitials> <revremark>brådskande programfixuppdatering</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:185 +#: C/index.docbook:191 msgid "" "<revnumber>1.16</revnumber> <date>14 Jan 2011</date> <authorinitials>sk</" "authorinitials> <revremark>bugfixes, layout improvements</revremark>" @@ -297,7 +305,7 @@ msgstr "" "authorinitials> <revremark>programfixar, layoutförbättringar</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:191 +#: C/index.docbook:197 msgid "" "<revnumber>1.15</revnumber> <date>21 May 2010</date> <authorinitials>sk</" "authorinitials> <revremark>bug and regression fixes</revremark>" @@ -306,7 +314,7 @@ msgstr "" "authorinitials> <revremark>program- och regressionsfixar</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:197 +#: C/index.docbook:203 msgid "" "<revnumber>1.14</revnumber> <date>28 March 2010</date> <authorinitials>sk</" "authorinitials> <revremark>bugfixes and performance improvements</revremark>" @@ -316,7 +324,7 @@ msgstr "" "revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:203 +#: C/index.docbook:209 msgid "" "<revnumber>1.13</revnumber> <date>18 December 2009</date> " "<authorinitials>sk</authorinitials> <revremark>broken tarball update</" @@ -327,7 +335,7 @@ msgstr "" "trasigt tar-arkiv</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:209 +#: C/index.docbook:215 msgid "" "<revnumber>1.12</revnumber> <date>18 December 2009</date> " "<authorinitials>sk</authorinitials> <revremark>new tool features and " @@ -338,7 +346,7 @@ msgstr "" "programfixar</revremark>" #. (itstool) path: revhistory/revision -#: C/index.docbook:215 +#: C/index.docbook:221 msgid "" "<revnumber>1.11</revnumber> <date>16 November 2008</date> " "<authorinitials>mal</authorinitials> <revremark>GNOME doc-utils migration</" @@ -349,12 +357,12 @@ msgstr "" "revremark>" #. (itstool) path: chapter/title -#: C/index.docbook:228 +#: C/index.docbook:234 msgid "Introduction" msgstr "Introduktion" #. (itstool) path: chapter/para -#: C/index.docbook:230 +#: C/index.docbook:236 msgid "" "This chapter introduces GTK-Doc and gives an overview of what it is and how " "it is used." @@ -363,12 +371,12 @@ msgstr "" "hur det används." #. (itstool) path: sect1/title -#: C/index.docbook:236 +#: C/index.docbook:242 msgid "What is GTK-Doc?" msgstr "Vad är GTK-Doc?" #. (itstool) path: sect1/para -#: C/index.docbook:238 +#: C/index.docbook:244 msgid "" "GTK-Doc is used to document C code. It is typically used to document the " "public API of libraries, such as the GTK+ and GNOME libraries. But it can " @@ -379,13 +387,13 @@ msgstr "" "biblioteken. Men det kan också användas för att dokumentera programkod." #. (itstool) path: sect1/title -#: C/index.docbook:246 +#: C/index.docbook:252 msgid "How Does GTK-Doc Work?" msgstr "Hur fungerar GTK-Doc?" # sebras: how do I translate header files? #. (itstool) path: sect1/para -#: C/index.docbook:248 +#: C/index.docbook:254 msgid "" "GTK-Doc works by using documentation of functions placed inside the source " "files in specially-formatted comment blocks, or documentation added to the " @@ -400,7 +408,7 @@ msgstr "" "huvudfiler; det kommer inte att producera utdata för statiska funktioner)." #. (itstool) path: sect1/para -#: C/index.docbook:255 +#: C/index.docbook:261 msgid "" "GTK-Doc consists of a number of python scripts, each performing a different " "step in the process." @@ -409,12 +417,12 @@ msgstr "" "i processen." #. (itstool) path: sect1/para -#: C/index.docbook:260 +#: C/index.docbook:266 msgid "There are 5 main steps in the process:" msgstr "Det finns 5 huvudsteg i processen:" #. (itstool) path: listitem/para -#: C/index.docbook:267 +#: C/index.docbook:273 msgid "" "<guilabel>Writing the documentation.</guilabel> The author fills in the " "source files with the documentation for each function, macro, structs or " @@ -426,7 +434,7 @@ msgstr "" # sebras: more header files... #. (itstool) path: listitem/para -#: C/index.docbook:276 +#: C/index.docbook:282 msgid "" "<guilabel>Gathering information about the code.</guilabel> " "<application>gtkdoc-scan</application> scans the header files of the code " @@ -462,7 +470,7 @@ msgstr "" "module>-overrides.txt</filename>." #. (itstool) path: listitem/para -#: C/index.docbook:293 +#: C/index.docbook:299 msgid "" "<application>gtkdoc-scangobj</application> can also be used to dynamically " "query a library about any GObject subclasses it exports. It saves " @@ -475,7 +483,7 @@ msgstr "" "vilka GObject-egenskaper och signaler det tillhandahåller." #. (itstool) path: listitem/para -#: C/index.docbook:299 +#: C/index.docbook:305 msgid "" "<application>gtkdoc-scanobj</application> should not be used anymore. It was " "needed in the past when GObject was still GtkObject inside gtk+." @@ -484,7 +492,7 @@ msgstr "" "behövdes tidigare när GObject fortfarande var GtkObject inuti gtk+." #. (itstool) path: listitem/para -#: C/index.docbook:306 +#: C/index.docbook:312 msgid "" "<guilabel>Generating the XML and HTML/PDF.</guilabel> <application>gtkdoc-" "mkdb</application> turns the template files into XML files in the <filename " @@ -502,7 +510,7 @@ msgstr "" "introspektionsdata." #. (itstool) path: listitem/para -#: C/index.docbook:315 +#: C/index.docbook:321 msgid "" "<application>gtkdoc-mkhtml</application> turns the XML files into HTML files " "in the <filename class=\"directory\">html/</filename> subdirectory. Likewise " @@ -515,7 +523,7 @@ msgstr "" "till ett PDF-dokument kallat <filename><package>.pdf</filename>." #. (itstool) path: listitem/para -#: C/index.docbook:321 +#: C/index.docbook:327 msgid "" "Files in <filename class=\"directory\">xml/</filename> and <filename class=" "\"directory\">html/</filename> directories are always overwritten. One " @@ -526,7 +534,7 @@ msgstr "" "aldrig redigera dem direkt." #. (itstool) path: listitem/para -#: C/index.docbook:329 +#: C/index.docbook:335 msgid "" "<guilabel>Fixing up cross-references between documents.</guilabel> After " "installing the HTML files, <application>gtkdoc-fixxref</application> can be " @@ -548,23 +556,23 @@ msgstr "" "(i de fall där dokumentationen finns installerad)." #. (itstool) path: sect1/title -#: C/index.docbook:347 +#: C/index.docbook:353 msgid "Getting GTK-Doc" msgstr "Hämta GTK-Doc" #. (itstool) path: sect2/title -#: C/index.docbook:350 +#: C/index.docbook:356 msgid "Requirements" msgstr "Krav" #. (itstool) path: sect2/para -#: C/index.docbook:351 +#: C/index.docbook:357 msgid "" "<guilabel>python 2/3</guilabel> - the main scripts are written in python." msgstr "<guilabel>python 2/3</guilabel> - huvudskripten är skrivna i python." #. (itstool) path: sect2/para -#: C/index.docbook:354 +#: C/index.docbook:360 msgid "" "<guilabel>xsltproc</guilabel> - the xslt processor from libxslt <ulink url=" "\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>" @@ -573,7 +581,7 @@ msgstr "" "\"http://xmlsoft.org/XSLT/\" type=\"http\">xmlsoft.org/XSLT/</ulink>" #. (itstool) path: sect2/para -#: C/index.docbook:358 +#: C/index.docbook:364 msgid "" "<guilabel>docbook-xsl</guilabel> - the docbook xsl stylesheets <ulink url=" "\"http://sourceforge.net/projects/docbook/files/docbook-xsl/\" type=\"http" @@ -585,7 +593,7 @@ msgstr "" # sebras: remind me how was highlighting translated..? #. (itstool) path: sect2/para -#: C/index.docbook:362 +#: C/index.docbook:368 msgid "" "One of <guilabel>source-highlight</guilabel>, <guilabel>highlight</guilabel> " "or <guilabel>vim</guilabel> - optional - used for syntax highlighting of " @@ -596,14 +604,14 @@ msgstr "" "syntaxfärgning av exempel" #. (itstool) path: sect1/title -#: C/index.docbook:370 +#: C/index.docbook:376 msgid "About GTK-Doc" msgstr "Om GTK-Doc" # TODO: https://gitlab.gnome.org/GNOME/gtk-doc/issues/52 # +sources code #. (itstool) path: sect1/para -#: C/index.docbook:372 +#: C/index.docbook:378 msgid "" "Historically GTK-Doc was used to generate template files from the sources " "code. These template files could be used by developers to enter the API " @@ -620,12 +628,12 @@ msgstr "" "föråldrat. I version 1.26 har mallstödet tagits bort." #. (itstool) path: sect1/para -#: C/index.docbook:382 C/index.docbook:396 +#: C/index.docbook:388 C/index.docbook:402 msgid "(FIXME)" msgstr "(FIXME)" #. (itstool) path: sect1/para -#: C/index.docbook:386 +#: C/index.docbook:392 msgid "" "(authors, web pages, mailing list, license, future plans, comparison with " "other similar systems.)" @@ -634,22 +642,22 @@ msgstr "" "andra liknande system.)" #. (itstool) path: sect1/title -#: C/index.docbook:394 +#: C/index.docbook:400 msgid "About this Manual" msgstr "Om denna handbok" #. (itstool) path: sect1/para -#: C/index.docbook:400 +#: C/index.docbook:406 msgid "(who it is meant for, where you can get it, license)" msgstr "(vem är den avsett för, var kan du få tag i den, licens)" #. (itstool) path: chapter/title -#: C/index.docbook:409 +#: C/index.docbook:415 msgid "Project Setup" msgstr "Projektkonfiguration" #. (itstool) path: chapter/para -#: C/index.docbook:411 +#: C/index.docbook:417 msgid "" "This Chapter describes the steps that are necessary to integrate GTK-Doc " "into your project. The integration of GTK-Doc into a project includes the " @@ -660,7 +668,7 @@ msgstr "" "steg:" #. (itstool) path: listitem/para -#: C/index.docbook:419 +#: C/index.docbook:425 msgid "" "Preparation of the directory structure and creating required configuration " "files for your GTK-Doc documentation (see <link linkend=\"settingup_docfiles" @@ -671,7 +679,7 @@ msgstr "" "\"> Att ställa in en skelettstruktur för dokumentation</link>)." #. (itstool) path: listitem/para -#: C/index.docbook:427 +#: C/index.docbook:433 msgid "" "Adjusting the build system to build your documentation using the GTK-Doc " "tools. Multiple build systems are supported, in this manual we describe how " @@ -686,7 +694,7 @@ msgstr "" "\"settingup_plain_makefiles\">vanliga Makefiler</link>." #. (itstool) path: listitem/para -#: C/index.docbook:437 +#: C/index.docbook:443 msgid "" "Adding GTK-Doc specific files to version control and deciding which files to " "ignore (see <link linkend=\"settingup_vcs\"> Integration with version " @@ -697,7 +705,7 @@ msgstr "" "Integrering med versionshanteringssystem</link>)." #. (itstool) path: chapter/para -#: C/index.docbook:445 +#: C/index.docbook:451 msgid "" "The following sections assume we work on a project called <code>meep</code>. " "This project contains two packages (or modules), a library called " @@ -709,13 +717,13 @@ msgstr "" "som kallas <code>meeper</code>." #. (itstool) path: sect1/title -#: C/index.docbook:454 +#: C/index.docbook:460 msgid "Setting up a skeleton documentation" msgstr "Att ställa in en skelettstruktur för dokumentation" # https://gitlab.gnome.org/GNOME/gtk-doc/issues/52 #. (itstool) path: sect1/para -#: C/index.docbook:456 +#: C/index.docbook:462 msgid "" "A common convention is to place documentation into a folder called " "<code>docs</code> inside your top-level project directory. We usually " @@ -748,12 +756,12 @@ msgstr "" "den matchar din katalogstruktur." #. (itstool) path: example/title -#: C/index.docbook:487 +#: C/index.docbook:493 msgid "Example directory structure of <emphasis>meep</emphasis> project" msgstr "Exempel på katalogstruktur för projektet <emphasis>meep</emphasis>" #. (itstool) path: example/programlisting -#: C/index.docbook:489 +#: C/index.docbook:495 #, no-wrap msgid "" "\n" @@ -781,7 +789,7 @@ msgstr "" " meeper/\n" #. (itstool) path: sect1/para -#: C/index.docbook:481 +#: C/index.docbook:487 msgid "" "In the following sections we will assume a directory structure for our " "<emphasis>meep</emphasis> project that uses the above conventions. <_:" @@ -791,12 +799,12 @@ msgstr "" "<emphasis>meep</emphasis> som följer konventionerna ovan. <_:example-1/>" #. (itstool) path: sect1/title -#: C/index.docbook:506 +#: C/index.docbook:512 msgid "Integration with Autotools" msgstr "Integrering med Autotools" #. (itstool) path: sect1/para -#: C/index.docbook:507 +#: C/index.docbook:513 msgid "" "Integration of GTK-Doc into an autotools-based build system requires the " "following steps:" @@ -805,7 +813,7 @@ msgstr "" "steg:" #. (itstool) path: listitem/para -#: C/index.docbook:513 +#: C/index.docbook:519 msgid "" "Ensure that <application>gtkdocize</application> is run once before the " "<filename>configure</filename> script. If an <filename>autogen.sh</filename> " @@ -818,7 +826,7 @@ msgstr "" "lägg till ett anrop till <application>gtkdocize</application>." #. (itstool) path: listitem/para -#: C/index.docbook:521 +#: C/index.docbook:527 msgid "" "The main purpose of <application>gtkdocize</application> is to make the " "<filename>gtk-doc.make</filename> Makefile and the <filename>gtk-doc.m4</" @@ -831,7 +839,7 @@ msgstr "" "eller länka in dem i projektet." #. (itstool) path: listitem/para -#: C/index.docbook:530 +#: C/index.docbook:536 msgid "" "Add the necessary <application>autoconf</application> macros to " "<filename>configure.ac</filename> to enable GTK-Doc in your build system to " @@ -845,7 +853,7 @@ msgstr "" # TODO: What? Can't parse this one. #. (itstool) path: listitem/para -#: C/index.docbook:536 +#: C/index.docbook:542 msgid "" "Among others with registers the <code>--enable-gtk-doc</code> option with " "the <filename>configure</filename> script." @@ -854,7 +862,7 @@ msgstr "" "<filename>configure</filename>-skriptet." #. (itstool) path: listitem/para -#: C/index.docbook:542 +#: C/index.docbook:548 msgid "" "Create an <application>automake</application> script for each application or " "library in your project. In the example used in this documentation this step " @@ -866,7 +874,7 @@ msgstr "" # TODO: how *TO* enable #. (itstool) path: sect1/para -#: C/index.docbook:551 +#: C/index.docbook:557 msgid "" "In the following sections, we will perform the above steps in reverse order. " "We start with the <application>automake</application> scripts and work our " @@ -880,12 +888,12 @@ msgstr "" "visar vi hur Gtk-Doc aktiveras i byggsystemet och hur dokumentationen byggs." #. (itstool) path: sect2/title -#: C/index.docbook:561 +#: C/index.docbook:567 msgid "Integration with automake" msgstr "Integrering med automake" #. (itstool) path: sect2/para -#: C/index.docbook:563 +#: C/index.docbook:569 msgid "" "First copy the <filename>Makefile.am</filename> from the <filename class=" "\"directory\">examples</filename> sub-directory of the <ulink url=\"https://" @@ -906,7 +914,7 @@ msgstr "" "vart och ett." #. (itstool) path: note/simpara -#: C/index.docbook:576 +#: C/index.docbook:582 msgid "" "Do not forget to add each <filename>Makefile.am</filename> to the " "<function>AC_CONFIG_FILES</function> macro in <filename>configure.ac</" @@ -921,12 +929,12 @@ msgstr "" "<function>AC_CONFIG_FILES</function>." #. (itstool) path: example/title -#: C/index.docbook:588 +#: C/index.docbook:594 msgid "Example directory structure with <filename>Makefiles.am</filename>" msgstr "Exempelkatalogstruktur med <filename>Makefiles.am</filename>" #. (itstool) path: example/programlisting -#: C/index.docbook:591 +#: C/index.docbook:597 #, no-wrap msgid "" "\n" @@ -958,7 +966,7 @@ msgstr "" " meeper/\n" #. (itstool) path: sect2/para -#: C/index.docbook:607 +#: C/index.docbook:613 msgid "" "Next, you need to customize the copied Makefiles and provide values for the " "various parameters in each <filename>Makefile.am</filename>. All settings " @@ -981,7 +989,7 @@ msgstr "" "stöds." #. (itstool) path: listitem/para -#: C/index.docbook:631 +#: C/index.docbook:637 msgid "" "<option>DOC_MODULE</option> is used to provide the name of the package that " "is being documentated (e.g. <code>meeper</code>, or <code>libmeep</code>)." @@ -990,7 +998,7 @@ msgstr "" "som dokumenteras (t.ex. <code>meeper</code> eller <code>libmeep</code>)." #. (itstool) path: listitem/para -#: C/index.docbook:638 +#: C/index.docbook:644 msgid "" "<option>DOC_SOURCE_DIR</option> is used to specify the location of source " "directory which GTK-Doc searches for your API documentation. This will " @@ -1003,7 +1011,7 @@ msgstr "" "underkatalog till den katalogen." #. (itstool) path: listitem/para -#: C/index.docbook:651 +#: C/index.docbook:657 msgid "" "<option>HFILE_GLOB</option> and <option>CFILE_GLOB</option> are used for " "dependencies. Each option take a file-glob (e.g. <code>HFILE_GLOB=" @@ -1017,7 +1025,7 @@ msgstr "" # TODO: (top_srcdir) #. (itstool) path: listitem/para -#: C/index.docbook:663 +#: C/index.docbook:669 msgid "" "<option>EXTRA_HFILES</option> allows to specify extra header files to " "include when scanning for API documentation, which are not found under " @@ -1030,7 +1038,7 @@ msgstr "" "extra.h</code>)." #. (itstool) path: listitem/para -#: C/index.docbook:673 +#: C/index.docbook:679 msgid "" "<option>IGNORE_HFILES</option> allows to specify header files or directories " "to ignore when scanning for API documentation. Use the basename of the file " @@ -1044,7 +1052,7 @@ msgstr "" # TODO: *image files* #. (itstool) path: listitem/para -#: C/index.docbook:683 +#: C/index.docbook:689 msgid "" "<option>HTML_IMAGES</option> allows to specify images files which will be " "copied into the <filename>html/</filename> directory of the generated " @@ -1059,7 +1067,7 @@ msgstr "" "icons/stock_about_24.png</code>)." #. (itstool) path: listitem/para -#: C/index.docbook:696 +#: C/index.docbook:702 msgid "" "<option>content_files</option> allows to specify extra files that are " "included by <code>$(DOC_MAIN_SGML_FILE)</code> (e.g. <code> " @@ -1070,7 +1078,7 @@ msgstr "" "building.xml changes-2.0.xml</code>)." #. (itstool) path: listitem/para -#: C/index.docbook:707 +#: C/index.docbook:713 msgid "" "<option>expand_content_files</option> allows to specify files where " "<emphasis>gtk-doc abbreviations</emphasis> such as <code>#GtkWidget</code> " @@ -1081,7 +1089,7 @@ msgstr "" "ex. <code> expand_content_files=running.xml</code>)." #. (itstool) path: sect2/para -#: C/index.docbook:625 +#: C/index.docbook:631 msgid "" "The following list explains the most relevant options. Check the example " "<filename>Makefile.am</filename> for additional options. <_:itemizedlist-1/>" @@ -1090,12 +1098,12 @@ msgstr "" "am</filename>-exemplet för ytterligare flaggor. <_:itemizedlist-1/>" #. (itstool) path: sect2/title -#: C/index.docbook:722 +#: C/index.docbook:728 msgid "Integration with autoconf" msgstr "Integrering med autoconf" #. (itstool) path: sect2/para -#: C/index.docbook:724 +#: C/index.docbook:730 msgid "" "Integration with <application>autoconf</application> is very simple and " "includes one required step and an additional optional (but recommended) " @@ -1113,7 +1121,7 @@ msgstr "" "<application>gtkdocize</application>." #. (itstool) path: warning/simpara -#: C/index.docbook:736 +#: C/index.docbook:742 msgid "" "Make sure that the <code>GTK_DOC_CHECK</code> macro is not indented. The " "macro must start at the beginning of the line and should not start with " @@ -1123,7 +1131,7 @@ msgstr "" "måste inledas på början av raden och får inte börja med blanktecken." #. (itstool) path: sect2/para -#: C/index.docbook:743 +#: C/index.docbook:749 msgid "" "The second step is to add the <code>AC_CONFIG_MACRO_DIR(m4)</code> to your " "<filename>configure.ac</filename>. This is not required but helps " @@ -1144,12 +1152,12 @@ msgstr "" "makrodefinitionsfilen kan hittas." #. (itstool) path: example/title -#: C/index.docbook:756 +#: C/index.docbook:762 msgid "Minimal integration with autoconf" msgstr "Minimal integrering med autoconf" #. (itstool) path: example/programlisting -#: C/index.docbook:757 +#: C/index.docbook:763 #, no-wrap msgid "" "\n" @@ -1165,12 +1173,12 @@ msgstr "" "GTK_DOC_CHECK([1.28])\n" #. (itstool) path: example/title -#: C/index.docbook:772 +#: C/index.docbook:778 msgid "Integration with optional gtk-doc dependency" msgstr "Integrering med valfritt gtk-doc-beroende" #. (itstool) path: example/programlisting -#: C/index.docbook:773 +#: C/index.docbook:779 #, no-wrap msgid "" "\n" @@ -1194,7 +1202,7 @@ msgstr "" "])\n" #. (itstool) path: sect2/para -#: C/index.docbook:766 +#: C/index.docbook:772 msgid "" "The above example works, but will require all developers to have gtk-doc " "installed. A better way is to make building the documentation optional as " @@ -1206,7 +1214,7 @@ msgstr "" # sebras: <function> or <symbol>? #. (itstool) path: sect2/para -#: C/index.docbook:786 +#: C/index.docbook:792 msgid "" "The first argument is used to check for the Gtk-Doc version at configure " "time. The 2nd, optional argument is used by <application>gtkdocize</" @@ -1219,32 +1227,32 @@ msgstr "" "lägger också till flera configure-flaggor:" #. (itstool) path: listitem/para -#: C/index.docbook:795 +#: C/index.docbook:801 msgid "--with-html-dir=PATH : path to installed docs" msgstr "--with-html-dir=SÖKVÄG : sökväg till installerad dokumentation" #. (itstool) path: listitem/para -#: C/index.docbook:796 +#: C/index.docbook:802 msgid "--enable-gtk-doc : use gtk-doc to build documentation [default=no]" msgstr "" "--enable-gtk-doc : använd gtk-doc för att bygga dokumentation " "[standardvärde=no]" #. (itstool) path: listitem/para -#: C/index.docbook:797 +#: C/index.docbook:803 msgid "" "--enable-gtk-doc-html : build documentation in html format [default=yes]" msgstr "" "--enable-gtk-doc-html : bygg dokumentation i html-format [standardvärde=yes]" #. (itstool) path: listitem/para -#: C/index.docbook:798 +#: C/index.docbook:804 msgid "--enable-gtk-doc-pdf : build documentation in pdf format [default=no]" msgstr "" "--enable-gtk-doc-pdf : bygg dokumentation i pdf-format [standardvärde=no]" #. (itstool) path: important/para -#: C/index.docbook:802 +#: C/index.docbook:808 msgid "" "GTK-Doc is disabled by default! Remember to pass the option <option>'--" "enable-gtk-doc'</option> to the next <filename>configure</filename> run. " @@ -1257,7 +1265,7 @@ msgstr "" "är rimligt för användare men inte för utvecklare)." #. (itstool) path: sect2/para -#: C/index.docbook:810 +#: C/index.docbook:816 msgid "" "After all changes to <filename>configure.ac</filename> are made, update the " "<filename>configure</filename> file. This can be done by re-running " @@ -1268,12 +1276,12 @@ msgstr "" "köra om <code>autogen.sh</code>." #. (itstool) path: sect2/title -#: C/index.docbook:818 +#: C/index.docbook:824 msgid "Integration with autogen" msgstr "Integrering med autogen" #. (itstool) path: sect2/para -#: C/index.docbook:820 +#: C/index.docbook:826 msgid "" "Most projects will have an <filename>autogen.sh</filename> script to setup " "the build infrastructure after the project was checked out from a version " @@ -1288,17 +1296,17 @@ msgstr "" "att kopiera nödvändiga filer som behövs av Gtk-Doc till källkatalogen." #. (itstool) path: sect2/para -#: C/index.docbook:828 +#: C/index.docbook:834 msgid "It should be run before autoreconf, autoheader, automake or autoconf." msgstr "Det bör köras före autoreconf, autoheader, automake eller autoconf." #. (itstool) path: example/title -#: C/index.docbook:833 +#: C/index.docbook:839 msgid "Running gtkdocize from autogen.sh" msgstr "Köra gtkdocize från autogen.sh" #. (itstool) path: example/programlisting -#: C/index.docbook:834 +#: C/index.docbook:840 #, no-wrap msgid "" "\n" @@ -1308,12 +1316,12 @@ msgstr "" "gtkdocize || exit 1\n" #. (itstool) path: example/title -#: C/index.docbook:842 +#: C/index.docbook:848 msgid "Conditionally run gtkdocize from autogen.sh" msgstr "Köra gtkdocize villkorligt från autogen.sh" #. (itstool) path: example/programlisting -#: C/index.docbook:843 +#: C/index.docbook:849 #, no-wrap msgid "" "\n" @@ -1333,7 +1341,7 @@ msgstr "" "fi\n" #. (itstool) path: sect2/para -#: C/index.docbook:854 +#: C/index.docbook:860 msgid "" "When running <application>gtkdocize</application> it copies <filename>gtk-" "doc.make</filename> to your project root (or any directory specified by the " @@ -1345,7 +1353,7 @@ msgstr "" # TODO: Strange last sentence #. (itstool) path: sect2/para -#: C/index.docbook:860 +#: C/index.docbook:866 msgid "" "<application>gtkdocize</application> checks your <filename>configure.ac</" "filename> script for the <function>GTK_DOC_CHECK</function> macro. The " @@ -1360,7 +1368,7 @@ msgstr "" "parametern i <function>GTK_DOC_CHECK</function>-makrot." #. (itstool) path: sect2/para -#: C/index.docbook:869 +#: C/index.docbook:875 msgid "" "Alternatively, additional arguments can also be passed to " "<application>gtkdocize</application> via the <function>GTKDOCIZE_FLAGS</" @@ -1373,12 +1381,12 @@ msgstr "" "<application>gtkdocize</application> i <filename>autogen.sh</filename>." #. (itstool) path: sect2/title -#: C/index.docbook:880 +#: C/index.docbook:886 msgid "Executing GTK-Doc from the Build System" msgstr "Köra GTK-Doc från byggsystemet" #. (itstool) path: sect2/para -#: C/index.docbook:882 +#: C/index.docbook:888 msgid "" "After the previous steps it's time to run the build. First we need to rerun " "<filename>autogen.sh</filename>. If this script runs configure for you, then " @@ -1391,7 +1399,7 @@ msgstr "" "<filename>configure</filename> med denna flagga efteråt." #. (itstool) path: sect2/para -#: C/index.docbook:889 +#: C/index.docbook:895 msgid "" "The first make run generates several additional files in the doc-" "directories. The important ones are: <filename><package>.types</" @@ -1404,12 +1412,12 @@ msgstr "" "sections.txt</filename>." #. (itstool) path: example/title -#: C/index.docbook:897 +#: C/index.docbook:903 msgid "Running the doc build" msgstr "Att köra dokumentationsbygget" #. (itstool) path: example/programlisting -#: C/index.docbook:898 +#: C/index.docbook:904 #, no-wrap msgid "" "\n" @@ -1421,7 +1429,7 @@ msgstr "" "make\n" #. (itstool) path: sect2/para -#: C/index.docbook:905 +#: C/index.docbook:911 msgid "" "Now you can point your browser to <filename>docs/reference/<package>/" "index.html</filename>. With this initial setup you will only see a very " @@ -1442,12 +1450,12 @@ msgstr "" "dokumentationsfiler." #. (itstool) path: sect1/title -#: C/index.docbook:921 +#: C/index.docbook:927 msgid "Integration with CMake build systems" msgstr "Integrering med CMake-byggsystem" #. (itstool) path: sect1/para -#: C/index.docbook:923 +#: C/index.docbook:929 msgid "" "GTK-Doc now provides a <filename>GtkDocConfig.cmake</filename> module (and " "the corresponding <filename>GtkDocConfigVersion.cmake</filename> module). " @@ -1460,12 +1468,12 @@ msgstr "" "kommando som du kan ställa in i din <filename>CMakeLists.txt</filename>-fil." #. (itstool) path: example/title -#: C/index.docbook:933 +#: C/index.docbook:939 msgid "Example of using GTK-Doc from CMake" msgstr "Exempel på användning av GTK-Doc från CMake" #. (itstool) path: example/programlisting -#: C/index.docbook:934 +#: C/index.docbook:940 #, no-wrap msgid "" "\n" @@ -1507,18 +1515,18 @@ msgstr "" " DESTINATION ${CMAKE_INSTALL_DOCDIR})\n" #. (itstool) path: sect1/para -#: C/index.docbook:931 +#: C/index.docbook:937 msgid "The following example shows how to use this command. <_:example-1/>" msgstr "" "Det följande exemplet visar hur du använder detta kommando. <_:example-1/>" #. (itstool) path: sect1/title -#: C/index.docbook:958 +#: C/index.docbook:964 msgid "Integration with plain makefiles or other build systems" msgstr "Integrering med vanliga makefiler eller andra byggsystem" #. (itstool) path: sect1/para -#: C/index.docbook:960 +#: C/index.docbook:966 msgid "" "In the case one does not want to use automake and therefore <filename>gtk-" "doc.mak</filename> one will need to call the gtkdoc tools in the right order " @@ -1529,12 +1537,12 @@ msgstr "" "verktygen i rätt ordning i sina egna makefiler (eller andra byggverktyg)." #. (itstool) path: example/title -#: C/index.docbook:967 +#: C/index.docbook:973 msgid "Documentation build steps" msgstr "Byggsteg för dokumentation" #. (itstool) path: example/programlisting -#: C/index.docbook:968 +#: C/index.docbook:974 #, no-wrap msgid "" "\n" @@ -1560,7 +1568,7 @@ msgstr "" "gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html\n" #. (itstool) path: sect1/para -#: C/index.docbook:982 +#: C/index.docbook:988 msgid "" "One will need to look at the <filename>Makefile.am</filename> and " "<filename>gtk-doc.mak</filename> to pick the extra options needed." @@ -1570,12 +1578,12 @@ msgstr "" "behövs." #. (itstool) path: sect1/title -#: C/index.docbook:989 +#: C/index.docbook:995 msgid "Integration with version control systems" msgstr "Integrering med versionshanteringssystem" #. (itstool) path: sect1/para -#: C/index.docbook:991 +#: C/index.docbook:997 msgid "" "As a rule of thumb, it's the files you edit which should go under version " "control. For typical projects it's these files: <filename><package>." @@ -1590,7 +1598,7 @@ msgstr "" "filename>." #. (itstool) path: sect1/para -#: C/index.docbook:999 +#: C/index.docbook:1005 msgid "" "Files in the <filename>xml/</filename> and <filename>html/</filename> " "directories should not go under version control. Neither should any of the " @@ -1601,12 +1609,12 @@ msgstr "" "filerna." #. (itstool) path: chapter/title -#: C/index.docbook:1009 +#: C/index.docbook:1015 msgid "Documenting the code" msgstr "Att dokumentera koden" #. (itstool) path: chapter/para -#: C/index.docbook:1011 +#: C/index.docbook:1017 msgid "" "GTK-Doc uses source code comment with a special syntax for code " "documentation. Further it retrieves information about your project structure " @@ -1619,12 +1627,12 @@ msgstr "" "syntaxen i kommentarerna." #. (itstool) path: example/title -#: C/index.docbook:1022 C/index.docbook:1048 +#: C/index.docbook:1028 C/index.docbook:1054 msgid "GTK-Doc comment block" msgstr "GTK-Doc-kommentarsblock" #. (itstool) path: example/programlisting -#: C/index.docbook:1023 +#: C/index.docbook:1029 #, no-wrap msgid "" "\n" @@ -1638,7 +1646,7 @@ msgstr "" "#endif\n" #. (itstool) path: chapter/para -#: C/index.docbook:1018 +#: C/index.docbook:1024 msgid "" "The GTK-Doc scanner can handle the majority of C headers fine. In the case " "of receiving warnings from the scanner that look like a special case, one " @@ -1649,13 +1657,13 @@ msgstr "" "GTK-Doc att hoppa över dem. <_:example-1/>" #. (itstool) path: note/title -#: C/index.docbook:1032 +#: C/index.docbook:1038 msgid "Limitations" msgstr "Begränsningar" # sebras: no 's in the original #. (itstool) path: note/para -#: C/index.docbook:1033 +#: C/index.docbook:1039 msgid "" "Note, that GTK-Doc's supports <code>#ifndef(__GTK_DOC_IGNORE__)</code> but " "not <code>#if !defined(__GTK_DOC_IGNORE__)</code> or other combinations." @@ -1664,12 +1672,12 @@ msgstr "" "inte <code>#if !defined(__GTK_DOC_IGNORE__)</code> eller andra kombinationer." #. (itstool) path: sect1/title -#: C/index.docbook:1043 +#: C/index.docbook:1049 msgid "Documentation comments" msgstr "Dokumentationskommentarer" #. (itstool) path: example/programlisting -#: C/index.docbook:1049 +#: C/index.docbook:1055 #, no-wrap msgid "" "\n" @@ -1685,7 +1693,7 @@ msgstr "" " */\n" #. (itstool) path: sect1/para -#: C/index.docbook:1045 +#: C/index.docbook:1051 msgid "" "A multiline comment that starts with an additional '*' marks a documentation " "block that will be processed by the GTK-Doc tools. <_:example-1/>" @@ -1695,7 +1703,7 @@ msgstr "" "example-1/>" #. (itstool) path: sect1/para -#: C/index.docbook:1058 +#: C/index.docbook:1064 msgid "" "The 'identifier' is one line with the name of the item the comment is " "related to. The syntax differs a little depending on the item. (TODO add " @@ -1706,7 +1714,7 @@ msgstr "" "till tabell som visar identifierare)" #. (itstool) path: sect1/para -#: C/index.docbook:1064 +#: C/index.docbook:1070 msgid "" "The 'documentation' block is also different for each symbol type. Symbol " "types that get parameters such as functions or macros have the parameter " @@ -1726,7 +1734,7 @@ msgstr "" "användbart i förformaterad text (kodlistningar)." #. (itstool) path: listitem/para -#: C/index.docbook:1081 +#: C/index.docbook:1087 msgid "" "What it is: The name for a class or function can sometimes be misleading for " "people coming from a different background." @@ -1735,7 +1743,7 @@ msgstr "" "vilseledande för personer med annan bakgrund." #. (itstool) path: listitem/para -#: C/index.docbook:1087 +#: C/index.docbook:1093 msgid "" "What it does: Tell about common uses. Put it in relation with the other API." msgstr "" @@ -1743,19 +1751,19 @@ msgstr "" "det andra API:t." #. (itstool) path: tip/para -#: C/index.docbook:1077 +#: C/index.docbook:1083 msgid "When documenting code, describe two aspects: <_:itemizedlist-1/>" msgstr "När du dokumenterar kod, beskriv två aspekter: <_:itemizedlist-1/>" #. (itstool) path: listitem/para -#: C/index.docbook:1102 +#: C/index.docbook:1108 msgid "Use function() to refer to functions or macros which take arguments." msgstr "" "Använd funktion() för att referera till funktioner eller makron som tar " "argument." #. (itstool) path: listitem/para -#: C/index.docbook:1107 +#: C/index.docbook:1113 msgid "" "Use @param to refer to parameters. Also use this when referring to " "parameters of other functions, related to the one being described." @@ -1765,13 +1773,13 @@ msgstr "" "beskrivs." #. (itstool) path: listitem/para -#: C/index.docbook:1113 +#: C/index.docbook:1119 msgid "Use %constant to refer to a constant, e.g. %G_TRAVERSE_LEAFS." msgstr "" "Använd %konstant för att referera till en konstant, t.ex. %G_TRAVERSE_LEAFS." #. (itstool) path: listitem/para -#: C/index.docbook:1118 +#: C/index.docbook:1124 msgid "" "Use #symbol to refer to other types of symbol, e.g. structs and enums and " "macros which don't take arguments." @@ -1780,17 +1788,17 @@ msgstr "" "strukturer eller uppräkningar och makron som inte tar argument." #. (itstool) path: listitem/para -#: C/index.docbook:1124 +#: C/index.docbook:1130 msgid "Use #Object::signal to refer to a GObject signal." msgstr "Använd #Objekt::signal för att referera till en GObject-signal." #. (itstool) path: listitem/para -#: C/index.docbook:1129 +#: C/index.docbook:1135 msgid "Use #Object:property to refer to a GObject property." msgstr "Använd #Objekt:egenskap för att referera till en GObject-egenskap." #. (itstool) path: listitem/para -#: C/index.docbook:1134 +#: C/index.docbook:1140 msgid "" "Use #Struct.field to refer to a field inside a structure and #GObjectClass." "foo_bar() to refer to a vmethod." @@ -1799,7 +1807,7 @@ msgstr "" "#GObjectKlass.foo_bar() för att referera till en virtuell metod." #. (itstool) path: sect1/para -#: C/index.docbook:1096 +#: C/index.docbook:1102 msgid "" "One advantage of hyper-text over plain-text is the ability to have links in " "the document. Writing the correct markup for a link can be tedious though. " @@ -1812,7 +1820,7 @@ msgstr "" "förkortningar. <_:itemizedlist-1/>" #. (itstool) path: tip/para -#: C/index.docbook:1143 +#: C/index.docbook:1149 msgid "" "If you need to use the special characters '<', '>', '()', '@', '%', or " "'#' in your documentation without GTK-Doc changing them you can use the XML " @@ -1827,7 +1835,7 @@ msgstr "" "kontrollsekvensen ”\\”." #. (itstool) path: sect1/para -#: C/index.docbook:1152 +#: C/index.docbook:1158 msgid "" "DocBook can do more than just links. One can also have lists, examples, " "headings, and images. As of version 1.20, the preferred way is to use a " @@ -1845,7 +1853,7 @@ msgstr "" "ett bindestreck." #. (itstool) path: sect1/para -#: C/index.docbook:1163 +#: C/index.docbook:1169 msgid "" "While markdown is now preferred one can mix both. One limitation here is " "that one can use docbook xml within markdown, but markdown within docbook " @@ -1856,7 +1864,7 @@ msgstr "" "inte." #. (itstool) path: sect1/para -#: C/index.docbook:1169 +#: C/index.docbook:1175 msgid "" "In older GTK-Doc releases, if you need support for additional formatting, " "you would need to enable the usage of docbook XML tags inside doc-comments " @@ -1872,12 +1880,12 @@ msgstr "" # sebras: markdown or Markdown? #. (itstool) path: example/title -#: C/index.docbook:1178 +#: C/index.docbook:1184 msgid "GTK-Doc comment block using Markdown" msgstr "GTK-Doc-kommentarsblock som använder Markdown" #. (itstool) path: example/programlisting -#: C/index.docbook:1179 +#: C/index.docbook:1185 #, no-wrap msgid "" "\n" @@ -1953,18 +1961,18 @@ msgstr "" " */\n" #. (itstool) path: sect1/para -#: C/index.docbook:1218 +#: C/index.docbook:1224 msgid "" "More examples of what markdown tags are supported can be found in the <ulink " -"url=\"https://wiki.gnome.org/Projects/GTK%2B/DocumentationSyntax/Markdown" -"\">GTK+ Documentation Markdown Syntax Reference</ulink>." +"url=\"https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/Markdown\">GTK " +"Documentation Markdown Syntax Reference</ulink>." msgstr "" "Fler exempel på vilka markdown-taggar som stöds hittas i <ulink url=" -"\"https://wiki.gnome.org/Projects/GTK%2B/DocumentationSyntax/Markdown" -"\">Referensen för GTK+-dokumentationens markdown-syntax</ulink>." +"\"https://wiki.gnome.org/Projects/GTK/DocumentationSyntax/Markdown" +"\">Referensen för GTK-dokumentationens markdown-syntax</ulink>." #. (itstool) path: tip/para -#: C/index.docbook:1224 +#: C/index.docbook:1230 msgid "" "As already mentioned earlier GTK-Doc is for documenting public API. Thus one " "cannot write documentation for static symbols. Nevertheless it is good to " @@ -1984,12 +1992,12 @@ msgstr "" "ställe i avsnittsfilen." #. (itstool) path: sect1/title -#: C/index.docbook:1239 +#: C/index.docbook:1245 msgid "Documenting sections" msgstr "Dokumentationsavsnitt" #. (itstool) path: sect1/para -#: C/index.docbook:1241 +#: C/index.docbook:1247 msgid "" "Each section of the documentation contains information about one class or " "module. To introduce the component one can write a section block. The short " @@ -2002,12 +2010,12 @@ msgstr "" "valfria." #. (itstool) path: example/title -#: C/index.docbook:1249 +#: C/index.docbook:1255 msgid "Section comment block" msgstr "Kommentarsblock för avsnitt" #. (itstool) path: example/programlisting -#: C/index.docbook:1250 +#: C/index.docbook:1256 #, no-wrap msgid "" "\n" @@ -2039,12 +2047,12 @@ msgstr "" " */\n" #. (itstool) path: varlistentry/term -#: C/index.docbook:1269 +#: C/index.docbook:1275 msgid "SECTION:<name>" msgstr "SECTION:<namn>" #. (itstool) path: listitem/para -#: C/index.docbook:1271 +#: C/index.docbook:1277 msgid "" "The name links the section documentation to the respective part in the " "<filename><package>-sections.txt</filename> file. The name given here " @@ -2057,12 +2065,12 @@ msgstr "" "filename>." #. (itstool) path: varlistentry/term -#: C/index.docbook:1280 +#: C/index.docbook:1286 msgid "@short_description" msgstr "@short_description" #. (itstool) path: listitem/para -#: C/index.docbook:1282 +#: C/index.docbook:1288 msgid "" "A one line description of the section, that later will appear after the " "links in the TOC and at the top of the section page." @@ -2071,12 +2079,12 @@ msgstr "" "innehållsförteckningen och lägst upp på avsnittssidan." #. (itstool) path: varlistentry/term -#: C/index.docbook:1289 +#: C/index.docbook:1295 msgid "@title" msgstr "@title" #. (itstool) path: listitem/para -#: C/index.docbook:1291 +#: C/index.docbook:1297 msgid "" "The section title defaults to <name> from the SECTION declaration. It " "can be overridden with the @title field." @@ -2085,12 +2093,12 @@ msgstr "" "kan åsidosättas med fältet @title." #. (itstool) path: varlistentry/term -#: C/index.docbook:1298 +#: C/index.docbook:1304 msgid "@section_id" msgstr "@section_id" #. (itstool) path: listitem/para -#: C/index.docbook:1300 +#: C/index.docbook:1306 msgid "" "Overrides the use of title as a section identifier. For GObjects the <" "title> is used as a section_id and for other sections it is <" @@ -2101,22 +2109,22 @@ msgstr "" "MODULE>-<title>." #. (itstool) path: varlistentry/term -#: C/index.docbook:1308 +#: C/index.docbook:1314 msgid "@see_also" msgstr "@see_also" #. (itstool) path: listitem/para -#: C/index.docbook:1310 +#: C/index.docbook:1316 msgid "A list of symbols that are related to this section." msgstr "En lista över symboler som är relaterade till detta avsnitt." #. (itstool) path: varlistentry/term -#: C/index.docbook:1316 +#: C/index.docbook:1322 msgid "@stability" msgstr "@stability" #. (itstool) path: listitem/para -#: C/index.docbook:1323 +#: C/index.docbook:1329 msgid "" "Stable - The intention of a Stable interface is to enable arbitrary third " "parties to develop applications to these interfaces, release them, and have " @@ -2133,7 +2141,7 @@ msgstr "" "motiverade." #. (itstool) path: listitem/para -#: C/index.docbook:1335 +#: C/index.docbook:1341 msgid "" "Unstable - Unstable interfaces are experimental or transitional. They are " "typically used to give outside developers early access to new or rapidly " @@ -2149,7 +2157,7 @@ msgstr "" "programfixversion till nästa." #. (itstool) path: listitem/para -#: C/index.docbook:1347 +#: C/index.docbook:1353 msgid "" "Private - An interface that can be used within the GNOME stack itself, but " "that is not documented for end-users. Such functions should only be used in " @@ -2160,7 +2168,7 @@ msgstr "" "på angivna och dokumenterade sätt." #. (itstool) path: listitem/para -#: C/index.docbook:1356 +#: C/index.docbook:1362 msgid "" "Internal - An interface that is internal to a module and does not require " "end-user documentation. Functions that are undocumented are assumed to be " @@ -2171,7 +2179,7 @@ msgstr "" "interna." #. (itstool) path: listitem/para -#: C/index.docbook:1318 +#: C/index.docbook:1324 msgid "" "An informal description of the stability level this API has. We recommend " "the use of one of these terms: <_:itemizedlist-1/>" @@ -2180,12 +2188,12 @@ msgstr "" "att använda en av dessa termer: <_:itemizedlist-1/>" #. (itstool) path: varlistentry/term -#: C/index.docbook:1368 +#: C/index.docbook:1374 msgid "@include" msgstr "@include" #. (itstool) path: listitem/para -#: C/index.docbook:1370 +#: C/index.docbook:1376 msgid "" "The <literal>#include</literal> files to show in the section synopsis (a " "comma separated list), overriding the global value from the <link linkend=" @@ -2198,12 +2206,12 @@ msgstr "" "Detta objekt är valfritt." #. (itstool) path: varlistentry/term -#: C/index.docbook:1379 +#: C/index.docbook:1385 msgid "@image" msgstr "@image" #. (itstool) path: listitem/para -#: C/index.docbook:1381 +#: C/index.docbook:1387 msgid "" "The image to display at the top of the reference page for this section. This " "will often be some sort of a diagram to illustrate the visual appearance of " @@ -2216,7 +2224,7 @@ msgstr "" "klasser. Detta objekt är valfritt." #. (itstool) path: tip/para -#: C/index.docbook:1392 +#: C/index.docbook:1398 msgid "" "To avoid unnecessary recompilation after doc-changes put the section docs " "into the c-source where possible." @@ -2225,12 +2233,12 @@ msgstr "" "avsnittsdokumentationen i c-källkoden där möjligt." #. (itstool) path: sect1/title -#: C/index.docbook:1401 +#: C/index.docbook:1407 msgid "Documenting symbols" msgstr "Dokumentationssymboler" #. (itstool) path: sect1/para -#: C/index.docbook:1403 +#: C/index.docbook:1409 msgid "" "Each symbol (function, macro, struct, enum, signal and property) is " "documented in a separate block. The block is best placed close to the " @@ -2246,12 +2254,12 @@ msgstr "" #. (itstool) path: sect2/title #. (itstool) path: example/title -#: C/index.docbook:1411 C/index.docbook:1477 +#: C/index.docbook:1417 C/index.docbook:1483 msgid "General tags" msgstr "Generella taggar" #. (itstool) path: sect2/para -#: C/index.docbook:1413 +#: C/index.docbook:1419 msgid "" "You can add versioning information to all documentation elements to tell " "when an API was introduced, or when it was deprecated." @@ -2260,29 +2268,29 @@ msgstr "" "att berätta när ett API introducerats eller blev föråldrat." #. (itstool) path: variablelist/title -#: C/index.docbook:1418 +#: C/index.docbook:1424 msgid "Versioning Tags" msgstr "Versioneringstaggar" #. (itstool) path: varlistentry/term -#: C/index.docbook:1419 +#: C/index.docbook:1425 msgid "Since:" msgstr "Since:" #. (itstool) path: listitem/para -#: C/index.docbook:1421 +#: C/index.docbook:1427 msgid "Description since which version of the code the API is available." msgstr "" "Beskrivning över från och med vilken version av koden som API:t är " "tillgängligt." #. (itstool) path: varlistentry/term -#: C/index.docbook:1426 +#: C/index.docbook:1432 msgid "Deprecated:" msgstr "Deprecated:" #. (itstool) path: listitem/para -#: C/index.docbook:1428 +#: C/index.docbook:1434 msgid "" "Paragraph denoting that this function should no be used anymore. The " "description should point the reader to the new API." @@ -2291,7 +2299,7 @@ msgstr "" "Beskrivningen bör peka läsaren vidare till det nya API:t." #. (itstool) path: sect2/para -#: C/index.docbook:1436 +#: C/index.docbook:1442 msgid "" "You can also add stability information to all documentation elements to " "indicate whether API stability is guaranteed for them for all future minor " @@ -2302,7 +2310,7 @@ msgstr "" "för dem för alla framtida programfix-versioner av projektet." #. (itstool) path: sect2/para -#: C/index.docbook:1442 +#: C/index.docbook:1448 msgid "" "The default stability level for all documentation elements can be set by " "passing the <option>--default-stability</option> argument to " @@ -2313,17 +2321,17 @@ msgstr "" "till <application>gtkdoc-mkdb</application> med endera av värdena nedan." #. (itstool) path: variablelist/title -#: C/index.docbook:1448 +#: C/index.docbook:1454 msgid "Stability Tags" msgstr "Stabilitetstaggar" #. (itstool) path: varlistentry/term -#: C/index.docbook:1449 +#: C/index.docbook:1455 msgid "Stability: Stable" msgstr "Stability: Stable" #. (itstool) path: listitem/para -#: C/index.docbook:1451 +#: C/index.docbook:1457 msgid "" "Mark the element as stable. This is for public APIs which are guaranteed to " "remain stable for all future minor releases of the project." @@ -2333,12 +2341,12 @@ msgstr "" "projektet." #. (itstool) path: varlistentry/term -#: C/index.docbook:1458 +#: C/index.docbook:1464 msgid "Stability: Unstable" msgstr "Stability: Unstable" #. (itstool) path: listitem/para -#: C/index.docbook:1460 +#: C/index.docbook:1466 msgid "" "Mark the element as unstable. This is for public APIs which are released as " "a preview before being stabilised." @@ -2347,12 +2355,12 @@ msgstr "" "på förhand innan de blivit stabiliserade." #. (itstool) path: varlistentry/term -#: C/index.docbook:1466 +#: C/index.docbook:1472 msgid "Stability: Private" msgstr "Stability: Private" #. (itstool) path: listitem/para -#: C/index.docbook:1468 +#: C/index.docbook:1474 msgid "" "Mark the element as private. This is for interfaces which can be used by " "tightly coupled modules, but not by arbitrary third parties." @@ -2361,7 +2369,7 @@ msgstr "" "av tätt sammankopplade moduler, men inte av godtyckliga tredje parter." #. (itstool) path: example/programlisting -#: C/index.docbook:1478 +#: C/index.docbook:1484 #, no-wrap msgid "" "\n" @@ -2400,13 +2408,13 @@ msgstr "" #. (itstool) path: sect2/title #. (itstool) path: example/title -#: C/index.docbook:1498 C/index.docbook:1508 +#: C/index.docbook:1504 C/index.docbook:1514 msgid "Annotations" msgstr "Noteringar" # sebras: was it called verkygstips? verktygshjälp? I forget... #. (itstool) path: sect2/para -#: C/index.docbook:1500 +#: C/index.docbook:1506 msgid "" "Documentation blocks can contain annotation-tags. These tags will be " "rendered with tooltips describing their meaning. The tags are used by " @@ -2421,7 +2429,7 @@ msgstr "" "GObjectIntrospection/Annotations\" type=\"http\">wikisidan</ulink>." #. (itstool) path: example/programlisting -#: C/index.docbook:1509 +#: C/index.docbook:1515 #, no-wrap msgid "" "\n" @@ -2462,12 +2470,12 @@ msgstr "" #. (itstool) path: sect2/title #. (itstool) path: example/title -#: C/index.docbook:1530 C/index.docbook:1559 +#: C/index.docbook:1536 C/index.docbook:1565 msgid "Function comment block" msgstr "Kommentarsblock för funktioner" #. (itstool) path: listitem/para -#: C/index.docbook:1536 +#: C/index.docbook:1542 msgid "" "Document whether returned objects, lists, strings, etc, should be freed/" "unrefed/released." @@ -2476,26 +2484,26 @@ msgstr "" "avrefereras/släppas." #. (itstool) path: listitem/para -#: C/index.docbook:1542 +#: C/index.docbook:1548 msgid "Document whether parameters can be NULL, and what happens if they are." msgstr "" "Dokumentera huruvida parametrar tillåts vara NULL och vad som händer om de " "är NULL." #. (itstool) path: listitem/para -#: C/index.docbook:1547 +#: C/index.docbook:1553 msgid "" "Mention interesting pre-conditions and post-conditions where appropriate." msgstr "Nämn intressanta förvillkor och eftervillkor där lämpligt." #. (itstool) path: sect2/para -#: C/index.docbook:1532 C/index.docbook:1618 +#: C/index.docbook:1538 C/index.docbook:1624 msgid "Please remember to: <_:itemizedlist-1/>" msgstr "Kom ihåg att: <_:itemizedlist-1/>" # sebras: Gtk-doc? GTK-Doc? gtk-doc? macros and functions? #. (itstool) path: sect2/para -#: C/index.docbook:1554 +#: C/index.docbook:1560 msgid "" "Gtk-doc assumes all symbols (macros, functions) starting with '_' are " "private. They are treated like static functions." @@ -2505,7 +2513,7 @@ msgstr "" # sebras: how to translate highlight? #. (itstool) path: example/programlisting -#: C/index.docbook:1560 +#: C/index.docbook:1566 #, no-wrap msgid "" "\n" @@ -2548,28 +2556,28 @@ msgstr "" " */\n" #. (itstool) path: variablelist/title -#: C/index.docbook:1581 +#: C/index.docbook:1587 msgid "Function tags" msgstr "Funktions-taggar" #. (itstool) path: varlistentry/term -#: C/index.docbook:1582 C/index.docbook:1789 +#: C/index.docbook:1588 C/index.docbook:1795 msgid "Returns:" msgstr "Returns:" #. (itstool) path: listitem/para -#: C/index.docbook:1584 +#: C/index.docbook:1590 msgid "Paragraph describing the returned result." msgstr "Stycke som beskriver det returnerade resultatet." #. (itstool) path: varlistentry/term -#: C/index.docbook:1589 +#: C/index.docbook:1595 msgid "@...:" msgstr "@...:" # sebras: variadic? #. (itstool) path: listitem/para -#: C/index.docbook:1591 +#: C/index.docbook:1597 msgid "" "In case the function has variadic arguments, you should use this tag " "(@Varargs: does also work for historic reasons)." @@ -2579,12 +2587,12 @@ msgstr "" #. (itstool) path: sect2/title #. (itstool) path: example/title -#: C/index.docbook:1601 C/index.docbook:1603 +#: C/index.docbook:1607 C/index.docbook:1609 msgid "Property comment block" msgstr "Kommentarsblock för egenskaper" #. (itstool) path: example/programlisting -#: C/index.docbook:1604 +#: C/index.docbook:1610 #, no-wrap msgid "" "\n" @@ -2605,12 +2613,12 @@ msgstr "" #. (itstool) path: sect2/title #. (itstool) path: example/title -#: C/index.docbook:1616 C/index.docbook:1635 +#: C/index.docbook:1622 C/index.docbook:1641 msgid "Signal comment block" msgstr "Kommentarsblock för signaler" #. (itstool) path: listitem/para -#: C/index.docbook:1622 +#: C/index.docbook:1628 msgid "" "Document when the signal is emitted and whether it is emitted before or " "after other signals." @@ -2619,12 +2627,12 @@ msgstr "" "efter andra signaler." #. (itstool) path: listitem/para -#: C/index.docbook:1628 +#: C/index.docbook:1634 msgid "Document what an application might do in the signal handler." msgstr "Dokumentera vad ett program kan göra i signalhanteraren." #. (itstool) path: example/programlisting -#: C/index.docbook:1636 +#: C/index.docbook:1642 #, no-wrap msgid "" "\n" @@ -2655,12 +2663,12 @@ msgstr "" #. (itstool) path: sect2/title #. (itstool) path: example/title -#: C/index.docbook:1653 C/index.docbook:1654 +#: C/index.docbook:1659 C/index.docbook:1660 msgid "Struct comment block" msgstr "Kommentarsblock för strukturer" #. (itstool) path: example/programlisting -#: C/index.docbook:1655 +#: C/index.docbook:1661 #, no-wrap msgid "" "\n" @@ -2690,7 +2698,7 @@ msgstr "" "} FooWidget;\n" #. (itstool) path: sect2/para -#: C/index.docbook:1670 +#: C/index.docbook:1676 msgid "" "Use <code>/*< private >*/</code> before the private struct fields you " "want to hide. Use <code>/*< public >*/</code> for the reverse " @@ -2701,7 +2709,7 @@ msgstr "" "beteendet." #. (itstool) path: sect2/para -#: C/index.docbook:1676 +#: C/index.docbook:1682 msgid "" "If the first field is \"g_iface\", \"parent_instance\" or \"parent_class\" " "it will be considered private automatically and doesn't need to be mentioned " @@ -2712,7 +2720,7 @@ msgstr "" "kommentarsblocket." #. (itstool) path: sect2/para -#: C/index.docbook:1682 +#: C/index.docbook:1688 msgid "" "Struct comment blocks can also be used for GObjects and GObjectClasses. It " "is usually a good idea to add a comment block for a class, if it has " @@ -2733,12 +2741,12 @@ msgstr "" #. (itstool) path: sect2/title #. (itstool) path: example/title -#: C/index.docbook:1694 C/index.docbook:1695 +#: C/index.docbook:1700 C/index.docbook:1701 msgid "Enum comment block" msgstr "Kommentarsblock för uppräkningar" #. (itstool) path: example/programlisting -#: C/index.docbook:1696 +#: C/index.docbook:1702 #, no-wrap msgid "" "\n" @@ -2772,7 +2780,7 @@ msgstr "" "} Something;\n" #. (itstool) path: sect2/para -#: C/index.docbook:1713 +#: C/index.docbook:1719 msgid "" "Use <code>/*< private >*/</code> before the private enum values you " "want to hide. Use <code>/*< public >*/</code> for the reverse " @@ -2783,13 +2791,13 @@ msgstr "" "beteendet." #. (itstool) path: sect1/title -#: C/index.docbook:1724 +#: C/index.docbook:1730 msgid "Inline program documentation" msgstr "Infogad programdokumentation" # sebras: how to translate inline? #. (itstool) path: sect1/para -#: C/index.docbook:1725 +#: C/index.docbook:1731 msgid "" "You can document programs and their commandline interface using inline " "documentation." @@ -2798,37 +2806,37 @@ msgstr "" "dokumentation." #. (itstool) path: variablelist/title -#: C/index.docbook:1731 +#: C/index.docbook:1737 msgid "Tags" msgstr "Taggar" #. (itstool) path: varlistentry/term -#: C/index.docbook:1733 +#: C/index.docbook:1739 msgid "PROGRAM" msgstr "PROGRAM" #. (itstool) path: listitem/para -#: C/index.docbook:1736 +#: C/index.docbook:1742 msgid "Defines the start of a program documentation." msgstr "Definierar början av programdokumentationen." #. (itstool) path: varlistentry/term -#: C/index.docbook:1743 +#: C/index.docbook:1749 msgid "@short_description:" msgstr "@short_description:" #. (itstool) path: listitem/para -#: C/index.docbook:1745 +#: C/index.docbook:1751 msgid "Defines a short description of the program. (Optional)" msgstr "Definierar en kort beskrivning av programmet. (Valfritt)" #. (itstool) path: varlistentry/term -#: C/index.docbook:1752 +#: C/index.docbook:1758 msgid "@synopsis:" msgstr "@synopsis:" #. (itstool) path: listitem/para -#: C/index.docbook:1754 +#: C/index.docbook:1760 msgid "" "Defines the arguments, or list of arguments that the program can take. " "(Optional)" @@ -2837,54 +2845,54 @@ msgstr "" "(Valfritt)" #. (itstool) path: varlistentry/term -#: C/index.docbook:1762 +#: C/index.docbook:1768 msgid "@see_also:" msgstr "@see_also:" #. (itstool) path: listitem/para -#: C/index.docbook:1764 +#: C/index.docbook:1770 msgid "See Also manual page section. (Optional)" msgstr "Se vidare i manualavsnitt. (Valfritt)" #. (itstool) path: varlistentry/term -#: C/index.docbook:1771 +#: C/index.docbook:1777 msgid "@arg:" msgstr "@arg:" #. (itstool) path: listitem/para -#: C/index.docbook:1773 +#: C/index.docbook:1779 msgid "Argument(s) passed to the program and their description. (Optional)" msgstr "" "Argument som skickas vidare till programmet och deras beskrivningar. " "(Valfritt)" #. (itstool) path: varlistentry/term -#: C/index.docbook:1780 +#: C/index.docbook:1786 msgid "Description:" msgstr "Beskrivning:" #. (itstool) path: listitem/para -#: C/index.docbook:1782 +#: C/index.docbook:1788 msgid "A longer description of the program." msgstr "En längre beskrivning av programmet." #. (itstool) path: listitem/para -#: C/index.docbook:1791 +#: C/index.docbook:1797 msgid "Specify what value(s) the program returns. (Optional)" msgstr "Ange vilka värden programmet returnerar. (Valfritt)" #. (itstool) path: sect2/title -#: C/index.docbook:1800 +#: C/index.docbook:1806 msgid "Example of program documentation." msgstr "Exempel på programdokumentation." #. (itstool) path: example/title -#: C/index.docbook:1801 +#: C/index.docbook:1807 msgid "Program documentation block" msgstr "Dokumentationsblock för program" #. (itstool) path: example/programlisting -#: C/index.docbook:1802 +#: C/index.docbook:1808 #, no-wrap msgid "" "\n" @@ -2928,19 +2936,19 @@ msgstr "" "}\n" #. (itstool) path: sect1/title -#: C/index.docbook:1828 +#: C/index.docbook:1834 msgid "Useful DocBook tags" msgstr "Användbara DocBook-taggar" #. (itstool) path: sect1/para -#: C/index.docbook:1830 +#: C/index.docbook:1836 msgid "" "Here are some DocBook tags which are most useful when documenting the code." msgstr "" "Här är några DocBook-taggar som är användbara när man dokumenterar koden." #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1839 +#: C/index.docbook:1845 #, no-wrap msgid "" "\n" @@ -2950,7 +2958,7 @@ msgstr "" "<link linkend=\"glib-Hash-Tables\">Hashtabeller</link>\n" #. (itstool) path: sect1/para -#: C/index.docbook:1835 +#: C/index.docbook:1841 msgid "" "To link to another section in the GTK docs: <_:informalexample-1/> The " "linkend is the SGML/XML id on the top item of the page you want to link to. " @@ -2966,7 +2974,7 @@ msgstr "" "konverteras till ”-” för att överensstämma med SGML/XML." #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1852 +#: C/index.docbook:1858 #, no-wrap msgid "" "\n" @@ -2976,7 +2984,7 @@ msgstr "" "<function>…</function>\n" #. (itstool) path: sect1/para -#: C/index.docbook:1849 +#: C/index.docbook:1855 msgid "" "To refer to an external function, e.g. a standard C function: <_:" "informalexample-1/>" @@ -2985,16 +2993,8 @@ msgstr "" "informalexample-1/>" #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1861 +#: C/index.docbook:1867 #, no-wrap -#| msgid "" -#| "\n" -#| "<example>\n" -#| " <title>Using a GHashTable.</title>\n" -#| " <programlisting>\n" -#| " ...\n" -#| " </programlisting>\n" -#| "</example>\n" msgid "" "\n" "<example>\n" @@ -3013,15 +3013,8 @@ msgstr "" "</example>\n" #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1872 +#: C/index.docbook:1878 #, no-wrap -#| msgid "" -#| "\n" -#| "<informalexample>\n" -#| " <programlisting>\n" -#| " ...\n" -#| " </programlisting>\n" -#| "</informalexample>\n" msgid "" "\n" "<informalexample>\n" @@ -3038,7 +3031,7 @@ msgstr "" "</informalexample>\n" #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1884 +#: C/index.docbook:1890 #, no-wrap msgid "" "\n" @@ -3052,7 +3045,7 @@ msgstr "" "]|\n" #. (itstool) path: sect1/para -#: C/index.docbook:1858 +#: C/index.docbook:1864 msgid "" "To include example code: <_:informalexample-1/> or possibly this, for very " "short code fragments which don't need a title: <_:informalexample-2/> In " @@ -3068,7 +3061,7 @@ msgstr "" "informalexample-3/>" #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1895 +#: C/index.docbook:1901 #, no-wrap msgid "" "\n" @@ -3100,12 +3093,12 @@ msgstr "" "</itemizedlist>\n" #. (itstool) path: sect1/para -#: C/index.docbook:1892 +#: C/index.docbook:1898 msgid "To include bulleted lists: <_:informalexample-1/>" msgstr "För att inkludera punktlistor: <_:informalexample-1/>" #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1915 +#: C/index.docbook:1921 #, no-wrap msgid "" "\n" @@ -3123,14 +3116,14 @@ msgstr "" "</note>\n" #. (itstool) path: sect1/para -#: C/index.docbook:1912 +#: C/index.docbook:1918 msgid "" "To include a note which stands out from the text: <_:informalexample-1/>" msgstr "" "För att inkludera en not som skiljer sig från texten: <_:informalexample-1/>" #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1928 +#: C/index.docbook:1934 #, no-wrap msgid "" "\n" @@ -3140,12 +3133,12 @@ msgstr "" "<type>unsigned char</type>\n" #. (itstool) path: sect1/para -#: C/index.docbook:1925 +#: C/index.docbook:1931 msgid "To refer to a type: <_:informalexample-1/>" msgstr "För att refera till en typ: <_:informalexample-1/>" #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1937 +#: C/index.docbook:1943 #, no-wrap msgid "" "\n" @@ -3155,7 +3148,7 @@ msgstr "" "<structname>XFontStruct</structname>\n" #. (itstool) path: sect1/para -#: C/index.docbook:1934 +#: C/index.docbook:1940 msgid "" "To refer to an external structure (not one described in the GTK docs): <_:" "informalexample-1/>" @@ -3164,7 +3157,7 @@ msgstr "" "dokumentationen): <_:informalexample-1/>" #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1946 +#: C/index.docbook:1952 #, no-wrap msgid "" "\n" @@ -3174,12 +3167,12 @@ msgstr "" "<structfield>len</structfield>\n" #. (itstool) path: sect1/para -#: C/index.docbook:1943 +#: C/index.docbook:1949 msgid "To refer to a field of a structure: <_:informalexample-1/>" msgstr "För att referera till ett fält för en struktur: <_:informalexample-1/>" #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1955 +#: C/index.docbook:1961 #, no-wrap msgid "" "\n" @@ -3189,7 +3182,7 @@ msgstr "" "<classname>GtkWidget</classname>\n" #. (itstool) path: sect1/para -#: C/index.docbook:1952 +#: C/index.docbook:1958 msgid "" "To refer to a class name, we could possibly use: <_:informalexample-1/> but " "you'll probably be using #GtkWidget instead (to automatically create a link " @@ -3202,7 +3195,7 @@ msgstr "" "\"documenting_syntax\">förkortningarna</link>)." #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1966 +#: C/index.docbook:1972 #, no-wrap msgid "" "\n" @@ -3212,12 +3205,12 @@ msgstr "" "<emphasis>Detta är viktigt</emphasis>\n" #. (itstool) path: sect1/para -#: C/index.docbook:1963 +#: C/index.docbook:1969 msgid "To emphasize text: <_:informalexample-1/>" msgstr "För att betona text: <_:informalexample-1/>" #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1975 +#: C/index.docbook:1981 #, no-wrap msgid "" "\n" @@ -3227,12 +3220,12 @@ msgstr "" "<filename>/home/användare/dokument</filename>\n" #. (itstool) path: sect1/para -#: C/index.docbook:1972 +#: C/index.docbook:1978 msgid "For filenames use: <_:informalexample-1/>" msgstr "För filnamn använd: <_:informalexample-1/>" #. (itstool) path: informalexample/programlisting -#: C/index.docbook:1984 +#: C/index.docbook:1990 #, no-wrap msgid "" "\n" @@ -3242,17 +3235,17 @@ msgstr "" "<keycombo><keycap>Control</keycap><keycap>L</keycap></keycombo>\n" #. (itstool) path: sect1/para -#: C/index.docbook:1981 +#: C/index.docbook:1987 msgid "To refer to keys use: <_:informalexample-1/>" msgstr "För att referera till tangenter använd: <_:informalexample-1/>" #. (itstool) path: chapter/title -#: C/index.docbook:1994 +#: C/index.docbook:2000 msgid "Filling the extra files" msgstr "Fylla i de extra filerna" #. (itstool) path: chapter/para -#: C/index.docbook:1996 +#: C/index.docbook:2002 msgid "" "There are a couple of extra files, that need to be maintained along with the " "inline source code comments: <filename><package>.types</filename>, " @@ -3265,12 +3258,12 @@ msgstr "" "paket>-sections.txt</filename>." #. (itstool) path: sect1/title -#: C/index.docbook:2005 +#: C/index.docbook:2011 msgid "Editing the types file" msgstr "Redigera typfilen" #. (itstool) path: sect1/para -#: C/index.docbook:2007 +#: C/index.docbook:2013 msgid "" "If your library or application includes GObjects, you want their signals, " "arguments/parameters and position in the hierarchy to be shown in the " @@ -3285,12 +3278,12 @@ msgstr "" "paket>.types</filename>." #. (itstool) path: example/title -#: C/index.docbook:2016 +#: C/index.docbook:2022 msgid "Example <package>.types file" msgstr "Exempel på filen <paket>.types" #. (itstool) path: example/programlisting -#: C/index.docbook:2017 +#: C/index.docbook:2023 #, no-wrap msgid "" "\n" @@ -3310,7 +3303,7 @@ msgstr "" "gtk_arrow_get_type\n" #. (itstool) path: sect1/para -#: C/index.docbook:2028 +#: C/index.docbook:2034 msgid "" "Since GTK-Doc 1.8 <application>gtkdoc-scan</application> can generate this " "list for you. Just add \"--rebuild-types\" to SCAN_OPTIONS in " @@ -3323,12 +3316,12 @@ msgstr "" "du inte distribuera typfilen eller versionshantera den." #. (itstool) path: sect1/title -#: C/index.docbook:2037 +#: C/index.docbook:2043 msgid "Editing the master document" msgstr "Redigera huvuddokumentet" #. (itstool) path: sect1/para -#: C/index.docbook:2039 +#: C/index.docbook:2045 msgid "" "GTK-Doc produces documentation in DocBook SGML/XML. When processing the " "inline source comments, the GTK-Doc tools generate one documentation page " @@ -3342,7 +3335,7 @@ msgstr "" # sebras: Its -> it's #. (itstool) path: sect1/para -#: C/index.docbook:2046 +#: C/index.docbook:2052 msgid "" "While GTK-Doc creates a template master document for you, later runs will " "not touch it again. This means that one can freely structure the " @@ -3360,7 +3353,7 @@ msgstr "" # sebras: for -> from Apart -> together/embedded... #. (itstool) path: tip/para -#: C/index.docbook:2056 +#: C/index.docbook:2062 msgid "" "Do not create tutorials as extra documents. Just write extra chapters. The " "benefit of directly embedding the tutorial for your library into the API " @@ -3375,7 +3368,7 @@ msgstr "" "blir uppdaterad tillsammans med biblioteket." #. (itstool) path: sect1/para -#: C/index.docbook:2065 +#: C/index.docbook:2071 msgid "" "So what are the things to change inside the master document? For a start is " "only a little. There are some placeholders (text in square brackets) there " @@ -3385,12 +3378,12 @@ msgstr "" "Det finns en del platshållare (text i hakparenteser) som du bör ta hand om." #. (itstool) path: example/title -#: C/index.docbook:2072 +#: C/index.docbook:2078 msgid "Master document header" msgstr "Huvuddokumentets huvud" #. (itstool) path: example/programlisting -#: C/index.docbook:2073 +#: C/index.docbook:2079 #, no-wrap msgid "" "\n" @@ -3420,7 +3413,7 @@ msgstr "" " <title>[Infoga titel här]</title>\n" #. (itstool) path: sect1/para -#: C/index.docbook:2089 +#: C/index.docbook:2095 msgid "" "In addition a few option elements are created in commented form. You can " "review these and enable them as you like." @@ -3429,12 +3422,12 @@ msgstr "" "Du kan granska dessa och aktivera dem enligt dina egna önskemål." #. (itstool) path: example/title -#: C/index.docbook:2095 +#: C/index.docbook:2101 msgid "Optional part in the master document" msgstr "Valfri del i huvuddokumentet" #. (itstool) path: example/programlisting -#: C/index.docbook:2096 +#: C/index.docbook:2102 #, no-wrap msgid "" "\n" @@ -3448,7 +3441,7 @@ msgstr "" " -->\n" #. (itstool) path: sect1/para -#: C/index.docbook:2104 +#: C/index.docbook:2110 msgid "" "Finally you need to add new section whenever you introduce one. The <link " "linkend=\"modernizing-gtk-doc-1-16\">gtkdoc-check</link> tool will remind " @@ -3460,12 +3453,12 @@ msgstr "" "infogats i dokumentationen." #. (itstool) path: example/title -#: C/index.docbook:2112 C/index.docbook:2147 +#: C/index.docbook:2118 C/index.docbook:2153 msgid "Including generated sections" msgstr "Inkludera genererade avsnitt" #. (itstool) path: example/programlisting -#: C/index.docbook:2113 +#: C/index.docbook:2119 #, no-wrap msgid "" "\n" @@ -3481,12 +3474,12 @@ msgstr "" " ...\n" #. (itstool) path: sect1/title -#: C/index.docbook:2125 +#: C/index.docbook:2131 msgid "Editing the section file" msgstr "Redigera avsnittsfilen" #. (itstool) path: sect1/para -#: C/index.docbook:2127 +#: C/index.docbook:2133 msgid "" "The section file is used to organise the documentation output by GTK-Doc. " "Here one specifies which symbol belongs to which module or class and control " @@ -3497,7 +3490,7 @@ msgstr "" "styra synligheten (publik eller privat)." #. (itstool) path: sect1/para -#: C/index.docbook:2133 +#: C/index.docbook:2139 msgid "" "The section file is a plain text file with tags delimiting sections. Blank " "lines are ignored and lines starting with a '#' are treated as comment lines." @@ -3507,7 +3500,7 @@ msgstr "" "kommentarsrader." #. (itstool) path: note/para -#: C/index.docbook:2140 +#: C/index.docbook:2146 msgid "" "While the tags make the file look like xml, it is not. Please do not close " "tags like <SUBSECTION>." @@ -3516,7 +3509,7 @@ msgstr "" "taggar så som <SUBSECTION>." #. (itstool) path: example/programlisting -#: C/index.docbook:2148 +#: C/index.docbook:2154 #, no-wrap msgid "" "\n" @@ -3548,7 +3541,7 @@ msgstr "" "</SECTION>\n" #. (itstool) path: sect1/para -#: C/index.docbook:2165 +#: C/index.docbook:2171 msgid "" "The <FILE> ... </FILE> tag is used to specify the file name, " "without any suffix. For example, using '<FILE>gnome-config</" @@ -3570,7 +3563,7 @@ msgstr "" "klassnamnet för GObjectet konverterat till gemener)." #. (itstool) path: sect1/para -#: C/index.docbook:2177 +#: C/index.docbook:2183 msgid "" "The <TITLE> ... </TITLE> tag is used to specify the title of the " "section. It is only useful before the templates (if used) are initially " @@ -3583,7 +3576,7 @@ msgstr "" "Vidare är detta föråldrat om man använder SECTIONS-kommentarer i källkoden." #. (itstool) path: sect1/para -#: C/index.docbook:2184 +#: C/index.docbook:2190 msgid "" "You can group items in the section by using the <SUBSECTION> tag. " "Currently it outputs a blank line between subsections in the synopsis " @@ -3613,7 +3606,7 @@ msgstr "" "beror på om de har publika poster (variabler, virtuella metoder)." #. (itstool) path: sect1/para -#: C/index.docbook:2203 +#: C/index.docbook:2209 msgid "" "You can also use <INCLUDE> ... </INCLUDE> to specify the " "#include files which are shown in the synopsis sections. It contains a comma-" @@ -3629,12 +3622,12 @@ msgstr "" "påverka det avsnittet." #. (itstool) path: chapter/title -#: C/index.docbook:2217 +#: C/index.docbook:2223 msgid "Controlling the result" msgstr "Kontrollera resultatet" #. (itstool) path: chapter/para -#: C/index.docbook:2219 +#: C/index.docbook:2225 msgid "" "A GTK-Doc run generates report files inside the documentation directory. The " "generated files are named: <filename><package>-undocumented.txt</" @@ -3649,7 +3642,7 @@ msgstr "" "kan visas eller efterbehandlas enkelt." #. (itstool) path: chapter/para -#: C/index.docbook:2228 +#: C/index.docbook:2234 msgid "" "The <filename><package>-undocumented.txt</filename> file starts with " "the documentation coverage summary. Below are two sections divided by blank " @@ -3665,7 +3658,7 @@ msgstr "" "dokumentation, men där en ny parameter har lagts till." #. (itstool) path: chapter/para -#: C/index.docbook:2237 +#: C/index.docbook:2243 msgid "" "The <filename><package>-undeclared.txt</filename> file lists symbols " "given in the <filename><package>-sections.txt</filename> but not found " @@ -3676,7 +3669,7 @@ msgstr "" "källkoden. Kontrollera om de har tagits bort eller om de är felstavade." #. (itstool) path: chapter/para -#: C/index.docbook:2244 +#: C/index.docbook:2250 msgid "" "The <filename><package>-unused.txt</filename> file lists symbol names, " "where the GTK-Doc scanner has found documentation, but does not know where " @@ -3690,7 +3683,7 @@ msgstr "" # sebras: <filename>? #. (itstool) path: tip/para -#: C/index.docbook:2252 +#: C/index.docbook:2258 msgid "" "Enable or add the <option>TESTS=$(GTKDOC_CHECK)</option> line in Makefile." "am. If at least GTK-Doc 1.9 is installed, this will run sanity checks during " @@ -3701,7 +3694,7 @@ msgstr "" "köra rimlighetskontroller under körning av <command>make check</command>." #. (itstool) path: chapter/para -#: C/index.docbook:2259 +#: C/index.docbook:2265 msgid "" "One can also look at the files produced by the source code scanner: " "<filename><package>-decl-list.txt</filename> and <filename><" @@ -3717,7 +3710,7 @@ msgstr "" "en symbol saknas bör man kontrollera om denna filen innehåller den." #. (itstool) path: chapter/para -#: C/index.docbook:2268 +#: C/index.docbook:2274 msgid "" "If the project is GObject based, one can also look into the files produced " "by the object scanner: <filename><package>.args.txt</filename>, " @@ -3738,12 +3731,12 @@ msgstr "" "<command>GTK_DOC_KEEP_INTERMEDIATE=1 make</command>." #. (itstool) path: chapter/title -#: C/index.docbook:2283 +#: C/index.docbook:2289 msgid "Modernizing the documentation" msgstr "Modernisera dokumentationen" #. (itstool) path: chapter/para -#: C/index.docbook:2285 +#: C/index.docbook:2291 msgid "" "GTK-Doc has been around for quite some time. In this section we list new " "features together with the version since when it is available." @@ -3752,12 +3745,12 @@ msgstr "" "tillsammans med vilken version de gjordes tillgängliga." #. (itstool) path: sect1/title -#: C/index.docbook:2291 +#: C/index.docbook:2297 msgid "GTK-Doc 1.9" msgstr "GTK-Doc 1.9" #. (itstool) path: sect1/para -#: C/index.docbook:2293 +#: C/index.docbook:2299 msgid "" "When using xml instead of sgml, one can actually name the master document " "<filename><package>-docs.xml</filename>." @@ -3766,7 +3759,7 @@ msgstr "" "huvuddokumentet <filename><paket>-docs.xml</filename>." #. (itstool) path: sect1/para -#: C/index.docbook:2298 +#: C/index.docbook:2304 msgid "" "This version supports <option>SCAN_OPTIONS=--rebuild-sections</option> in " "<filename>Makefile.am</filename>. When this is enabled, the <filename><" @@ -3787,7 +3780,7 @@ msgstr "" "<code>meld <paket>-decl-list.txt <paket>-sections.txt</code>." #. (itstool) path: sect1/para -#: C/index.docbook:2309 +#: C/index.docbook:2315 msgid "" "Version 1.8 already introduced the syntax for documenting sections in the " "sources instead of the separate files under <filename class=\"directory" @@ -3809,12 +3802,12 @@ msgstr "" "filename> så är du klar." #. (itstool) path: sect1/title -#: C/index.docbook:2321 +#: C/index.docbook:2327 msgid "GTK-Doc 1.10" msgstr "GTK-Doc 1.10" #. (itstool) path: sect1/para -#: C/index.docbook:2323 +#: C/index.docbook:2329 msgid "" "This version supports <option>SCAN_OPTIONS=--rebuild-types</option> in " "<filename>Makefile.am</filename>. When this is enabled, the <filename><" @@ -3831,17 +3824,17 @@ msgstr "" "filename> för kod som bara byggs ibland." #. (itstool) path: sect1/title -#: C/index.docbook:2334 +#: C/index.docbook:2340 msgid "GTK-Doc 1.16" msgstr "GTK-Doc 1.16" #. (itstool) path: example/title -#: C/index.docbook:2340 +#: C/index.docbook:2346 msgid "Enable gtkdoc-check" msgstr "Aktivera gtkdoc-check" #. (itstool) path: example/programlisting -#: C/index.docbook:2341 +#: C/index.docbook:2347 #, no-wrap msgid "" "\n" @@ -3861,7 +3854,7 @@ msgstr "" "endif\n" #. (itstool) path: sect1/para -#: C/index.docbook:2336 +#: C/index.docbook:2342 msgid "" "This version includes a new tool called gtkdoc-check. This tool can run a " "set of sanity checks on your documentation. It is enabled by adding these " @@ -3873,12 +3866,12 @@ msgstr "" "am</filename>. <_:example-1/>" #. (itstool) path: sect1/title -#: C/index.docbook:2354 +#: C/index.docbook:2360 msgid "GTK-Doc 1.20" msgstr "GTK-Doc 1.20" #. (itstool) path: sect1/para -#: C/index.docbook:2356 +#: C/index.docbook:2362 msgid "" "Version 1.18 brought some initial markdown support. Using markdown in doc " "comments is less intrusive than writing docbook xml. This version improves a " @@ -3892,17 +3885,17 @@ msgstr "" "\">kommentarsyntax</link> finnas alla detaljer." #. (itstool) path: sect1/title -#: C/index.docbook:2366 +#: C/index.docbook:2372 msgid "GTK-Doc 1.25" msgstr "GTK-Doc 1.25" #. (itstool) path: example/title -#: C/index.docbook:2377 +#: C/index.docbook:2383 msgid "Use pre-generated entities" msgstr "Att använda förgenererade entiteter" #. (itstool) path: example/programlisting -#: C/index.docbook:2378 +#: C/index.docbook:2384 #, no-wrap msgid "" "\n" @@ -3944,7 +3937,7 @@ msgstr "" " </bookinfo>\n" #. (itstool) path: sect1/para -#: C/index.docbook:2368 +#: C/index.docbook:2374 msgid "" "The makefiles shipped with this version generate an entity file at " "<filename>xml/gtkdocentities.ent</filename>, containing entities for e.g. " @@ -3963,12 +3956,12 @@ msgstr "" "kommer att använda samma xml-huvud i genererade xml-filer. <_:example-1/>" #. (itstool) path: chapter/title -#: C/index.docbook:2403 +#: C/index.docbook:2409 msgid "Documenting other interfaces" msgstr "Dokumentera andra gränssnitt" #. (itstool) path: chapter/para -#: C/index.docbook:2405 +#: C/index.docbook:2411 msgid "" "So far we have been using GTK-Doc to document the API of code. The next " "sections contain suggestions how the tools can be used to document other " @@ -3979,12 +3972,12 @@ msgstr "" "också dokumentera andra gränssnitt." #. (itstool) path: sect1/title -#: C/index.docbook:2412 +#: C/index.docbook:2418 msgid "Command line options and man pages" msgstr "Kommandoradsflaggor och mansidor" #. (itstool) path: sect1/para -#: C/index.docbook:2414 +#: C/index.docbook:2420 msgid "" "As one can generate man pages for a docbook refentry as well, it sounds like " "a good idea to use it for that purpose. This way the interface is part of " @@ -3995,13 +3988,13 @@ msgstr "" "gränssnittet att vara en del av referensen och man får mansidan gratis." #. (itstool) path: sect2/title -#: C/index.docbook:2421 +#: C/index.docbook:2427 msgid "Document the tool" msgstr "Dokumentera verktyget" # sebras: strange English #. (itstool) path: sect2/para -#: C/index.docbook:2423 +#: C/index.docbook:2429 msgid "" "Create one refentry file per tool. Following <link linkend=" "\"settingup_docfiles\">our example</link> we would call it <filename>meep/" @@ -4016,17 +4009,17 @@ msgstr "" "väl som exempel i glib." #. (itstool) path: sect2/title -#: C/index.docbook:2433 +#: C/index.docbook:2439 msgid "Adding the extra configure check" msgstr "Lägga till den extra configure-kontrollen" #. (itstool) path: example/title -#: C/index.docbook:2436 C/index.docbook:2454 +#: C/index.docbook:2442 C/index.docbook:2460 msgid "Extra configure checks" msgstr "Lägga till extra configure-kontroller" #. (itstool) path: example/programlisting -#: C/index.docbook:2437 +#: C/index.docbook:2443 #, no-wrap msgid "" "\n" @@ -4048,12 +4041,12 @@ msgstr "" "AM_CONDITIONAL(ENABLE_MAN, test x$enable_man != xno)\n" #. (itstool) path: sect2/title -#: C/index.docbook:2451 +#: C/index.docbook:2457 msgid "Adding the extra makefile rules" msgstr "Lägga till de extra makefilsreglerna" #. (itstool) path: example/programlisting -#: C/index.docbook:2455 +#: C/index.docbook:2461 #, no-wrap msgid "" "\n" @@ -4089,12 +4082,12 @@ msgstr "" "EXTRA_DIST += meep.xml\n" #. (itstool) path: sect1/title -#: C/index.docbook:2477 +#: C/index.docbook:2483 msgid "DBus interfaces" msgstr "DBus-gränssnitt" #. (itstool) path: sect1/para -#: C/index.docbook:2479 +#: C/index.docbook:2485 msgid "" "(FIXME: http://hal.freedesktop.org/docs/DeviceKit/DeviceKit.html, http://" "cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)" @@ -4103,27 +4096,27 @@ msgstr "" "cgit.freedesktop.org/DeviceKit/DeviceKit/tree/doc/dbus)" #. (itstool) path: chapter/title -#: C/index.docbook:2488 +#: C/index.docbook:2494 msgid "Frequently asked questions" msgstr "Frågor och svar" #. (itstool) path: segmentedlist/segtitle -#: C/index.docbook:2492 +#: C/index.docbook:2498 msgid "Question" msgstr "Fråga" #. (itstool) path: segmentedlist/segtitle -#: C/index.docbook:2493 +#: C/index.docbook:2499 msgid "Answer" msgstr "Svar" #. (itstool) path: seglistitem/seg -#: C/index.docbook:2495 +#: C/index.docbook:2501 msgid "No class hierarchy." msgstr "Ingen klasshierarki." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2496 +#: C/index.docbook:2502 msgid "" "The objects <function>xxx_get_type()</function> function has not been " "entered into the <filename><package>.types</filename> file." @@ -4132,12 +4125,12 @@ msgstr "" "filen <filename><paket>.types</filename>." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2502 +#: C/index.docbook:2508 msgid "Still no class hierarchy." msgstr "Fortfarande ingen klasshierarki." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2503 +#: C/index.docbook:2509 msgid "" "Missing or wrong naming in <filename><package>-sections.txt</filename> " "file (see <ulink url=\"http://mail.gnome.org/archives/gtk-doc-list/2003-" @@ -4148,12 +4141,12 @@ msgstr "" "October/msg00006.html\">förklaring</ulink>)." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2509 +#: C/index.docbook:2515 msgid "Damn, I have still no class hierarchy." msgstr "Förbannat, jag har fortfarande ingen klasshierarki." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2510 +#: C/index.docbook:2516 msgid "" "Is the object name (name of the instance struct, e.g. <type>GtkWidget</" "type>) part of the normal section (don't put this into Standard or Private " @@ -4164,12 +4157,12 @@ msgstr "" "Standard eller Private)." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2517 +#: C/index.docbook:2523 msgid "No symbol index." msgstr "Inget symbolindex." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2518 +#: C/index.docbook:2524 msgid "" "Does the <filename><package>-docs.{xml,sgml}</filename> contain a " "index that xi:includes the generated index?" @@ -4178,12 +4171,12 @@ msgstr "" "inkluderar det genererade indexet med xi:include?" #. (itstool) path: seglistitem/seg -#: C/index.docbook:2524 +#: C/index.docbook:2530 msgid "Symbols are not linked to their doc-section." msgstr "Symboler är inte länkade till deras dokumentationsavsnitt." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2525 +#: C/index.docbook:2531 msgid "" "Is the doc-comment using the correct markup (added #,% or ())? Check if the " "gtkdoc-fixxref warns about unresolvable xrefs." @@ -4193,12 +4186,12 @@ msgstr "" "korsreferenser." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2531 +#: C/index.docbook:2537 msgid "A new class does not appear in the docs." msgstr "En ny klass dyker inte upp i dokumentationen." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2532 +#: C/index.docbook:2538 msgid "" "Is the new page xi:included from <filename><package>-docs.{xml,sgml}</" "filename>." @@ -4207,12 +4200,12 @@ msgstr "" "docs.{xml,sgml}</filename>." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2538 +#: C/index.docbook:2544 msgid "A new symbol does not appear in the docs." msgstr "En ny symbol dyker inte upp i dokumentationen." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2539 +#: C/index.docbook:2545 msgid "" "Is the doc-comment properly formatted. Check for spelling mistakes in the " "begin of the comment. Check if the gtkdoc-fixxref warns about unresolvable " @@ -4225,12 +4218,12 @@ msgstr "" "paket>-sections.txt</filename> i ett publikt avsnitt." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2547 +#: C/index.docbook:2553 msgid "A type is missing from the class hierarchy." msgstr "En typ saknas från klasshierarkin." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2548 +#: C/index.docbook:2554 msgid "" "If the type is listed in <filename><package>.hierarchy</filename> but " "not in <filename>xml/tree_index.sgml</filename> then double check that the " @@ -4245,12 +4238,12 @@ msgstr "" "privat kommer den inte att visas." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2557 +#: C/index.docbook:2563 msgid "I get foldoc links for all gobject annotations." msgstr "Jag får foldoc-länkar för alla gobject-noteringar." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2558 +#: C/index.docbook:2564 msgid "" "Check that <filename>xml/annotation-glossary.xml</filename> is xi:included " "from <filename><package>-docs.{xml,sgml}</filename>." @@ -4260,12 +4253,12 @@ msgstr "" "filename>." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2566 +#: C/index.docbook:2572 msgid "Parameter described in source code comment block but does not exist" msgstr "Parameter beskriven i kommentarsblock i källkoden men existerar inte" #. (itstool) path: seglistitem/seg -#: C/index.docbook:2567 +#: C/index.docbook:2573 msgid "" "Check if the prototype in the header has different parameter names as in the " "source." @@ -4273,12 +4266,12 @@ msgstr "" "Kontrollera om prototypen i huvudet har andra parameternamn än i källkoden." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2572 +#: C/index.docbook:2578 msgid "multiple \"IDs\" for constraint linkend: XYZ" msgstr "multipla ”ID:n” för begränsat länkslut: XYZ" #. (itstool) path: seglistitem/seg -#: C/index.docbook:2573 +#: C/index.docbook:2579 msgid "" "Symbol XYZ appears twice in <filename><package>-sections.txt</" "filename> file." @@ -4287,19 +4280,19 @@ msgstr "" "txt</filename>." #. (itstool) path: seglistitem/seg -#: C/index.docbook:2576 +#: C/index.docbook:2582 msgid "" "Element typename in namespace '' encountered in para, but no template " "matches." msgstr "Elementtypnamn i namnrymd ”” påträffat i para, men ingen mall matchar." #. (itstool) path: chapter/title -#: C/index.docbook:2583 +#: C/index.docbook:2589 msgid "Tools related to gtk-doc" msgstr "Verktyg relaterade till gtk-doc" #. (itstool) path: chapter/para -#: C/index.docbook:2585 +#: C/index.docbook:2591 msgid "" "GtkDocPlugin - a <ulink url=\"http://trac-hacks.org/wiki/GtkDocPlugin\">Trac " "GTK-Doc</ulink> integration plugin, that adds API docs to a trac site and " @@ -4310,7 +4303,7 @@ msgstr "" "dokumentation till en trac-webbplats och integrerar med trac-sökningen." #. (itstool) path: chapter/para -#: C/index.docbook:2590 +#: C/index.docbook:2596 msgid "" "Gtkdoc-depscan - a tool (part of gtk-doc) to check used API against since " "tags in the API to determine the minimum required version." diff --git a/meson.build b/meson.build index 0345989..3406e82 100644 --- a/meson.build +++ b/meson.build @@ -1,5 +1,5 @@ project('gtk-doc', 'c', - version: '1.32.1', + version: '1.33.1', license: 'GPL2+', meson_version: '>= 0.50.0', # needed for https://mesonbuild.com/Python-module.html#path ) @@ -22,7 +22,7 @@ bindir = join_paths(prefix, get_option('bindir')) libdir = join_paths(prefix, get_option('libdir')) datadir = join_paths(prefix, get_option('datadir')) -cmakedatadir = join_paths(datadir, 'cmake') +cmakedatadir = join_paths(libdir, 'cmake') autoconfdatadir = join_paths(datadir, 'aclocal') pkgdir = join_paths(datadir, package_name) diff --git a/style/style.css b/style/style.css index 6f0bc25..e62807a 100644 --- a/style/style.css +++ b/style/style.css @@ -61,18 +61,6 @@ a:hover color: #729fcf; } -div.informaltable table -{ - border-collapse: separate; - border-spacing: 1em 0.3em; - border: none; -} - -div.informaltable table td, div.informaltable table th -{ - vertical-align: top; -} - .function_type, .variable_type, .property_type, @@ -127,6 +115,7 @@ td p margin: 0.25em; } +div.informaltable table[border="1"], div.table table { border-collapse: collapse; @@ -135,6 +124,8 @@ div.table table border: solid 1px #babdb6; } +div.informaltable table[border="1"] td, +div.informaltable table th, div.table table td, div.table table th { /* tango:aluminium 3 */ @@ -143,6 +134,7 @@ div.table table td, div.table table th vertical-align: top; } +div.informaltable table[border="1"] th, div.table table th { /* tango:aluminium 2 */ diff --git a/tests/Makefile.am b/tests/Makefile.am index d2d0b86..c266ce9 100644 --- a/tests/Makefile.am +++ b/tests/Makefile.am @@ -51,6 +51,16 @@ coverage: python3-coverage html --include="*/gtkdoc/*.py"; \ python3-coverage report --include="*/gtkdoc/*.py" +EXTRA_DIST += \ + gtkdocentities.ent.in \ + helpers/gtkdoc_check_runner.py \ + helpers/gtkdoc_fixxref_runner.py \ + helpers/gtkdoc_mkdb_runner.py \ + helpers/gtkdoc_mkhtml_runner.py \ + helpers/gtkdoc_scan_runner.py \ + helpers/gtkdoc_scangobj_runner.py \ + helpers/meson.build \ + meson.build .PHONY: snapshot diff --git a/tests/annotations/Makefile.am b/tests/annotations/Makefile.am index 1653011..1bd72fd 100644 --- a/tests/annotations/Makefile.am +++ b/tests/annotations/Makefile.am @@ -8,4 +8,6 @@ check-local: clean endif +EXTRA_DIST = meson.build + -include $(top_srcdir)/git.mk diff --git a/tests/annotations/docs/Makefile.am b/tests/annotations/docs/Makefile.am index 8cf5c7b..262ba91 100644 --- a/tests/annotations/docs/Makefile.am +++ b/tests/annotations/docs/Makefile.am @@ -72,4 +72,7 @@ TESTS_ENVIRONMENT = \ PATH=$(abs_top_builddir):$(srcdir):$(PATH) endif +EXTRA_DIST += meson.build +EXTRA_DIST += xml/meson.build + -include $(top_srcdir)/git.mk diff --git a/tests/bugs/Makefile.am b/tests/bugs/Makefile.am index ad34ec6..1bd72fd 100644 --- a/tests/bugs/Makefile.am +++ b/tests/bugs/Makefile.am @@ -8,5 +8,6 @@ check-local: clean endif +EXTRA_DIST = meson.build -include $(top_srcdir)/git.mk diff --git a/tests/bugs/docs/Makefile.am b/tests/bugs/docs/Makefile.am index 2f33b00..4b0dd4e 100644 --- a/tests/bugs/docs/Makefile.am +++ b/tests/bugs/docs/Makefile.am @@ -74,4 +74,7 @@ TESTS_ENVIRONMENT = \ PATH=$(abs_top_builddir):$(srcdir):$(PATH) endif +EXTRA_DIST += meson.build +EXTRA_DIST += xml/meson.build + -include $(top_srcdir)/git.mk diff --git a/tests/empty/Makefile.am b/tests/empty/Makefile.am index c854e6a..6695f6c 100644 --- a/tests/empty/Makefile.am +++ b/tests/empty/Makefile.am @@ -9,5 +9,6 @@ check-local: clean endif +EXTRA_DIST = meson.build -include $(top_srcdir)/git.mk diff --git a/tests/empty/docs/Makefile.am b/tests/empty/docs/Makefile.am index 3fb5d69..f126d44 100644 --- a/tests/empty/docs/Makefile.am +++ b/tests/empty/docs/Makefile.am @@ -83,4 +83,7 @@ CLEANFILES += \ tester-docs.xml \ tester-sections.txt +EXTRA_DIST += meson.build +EXTRA_DIST += xml/meson.build + -include $(top_srcdir)/git.mk diff --git a/tests/fail/Makefile.am b/tests/fail/Makefile.am index ad34ec6..1bd72fd 100644 --- a/tests/fail/Makefile.am +++ b/tests/fail/Makefile.am @@ -8,5 +8,6 @@ check-local: clean endif +EXTRA_DIST = meson.build -include $(top_srcdir)/git.mk diff --git a/tests/fail/docs/Makefile.am b/tests/fail/docs/Makefile.am index c715afd..1588ec4 100644 --- a/tests/fail/docs/Makefile.am +++ b/tests/fail/docs/Makefile.am @@ -72,4 +72,7 @@ TESTS_ENVIRONMENT = \ PATH=$(abs_top_builddir):$(srcdir):$(PATH) endif +EXTRA_DIST += meson.build +EXTRA_DIST += xml/meson.build + -include $(top_srcdir)/git.mk diff --git a/tests/gobject/Makefile.am b/tests/gobject/Makefile.am index 7eecd38..d12bf66 100644 --- a/tests/gobject/Makefile.am +++ b/tests/gobject/Makefile.am @@ -8,6 +8,8 @@ check-local: clean endif -EXTRA_DIST = examples/gobject.c +EXTRA_DIST = \ + examples/gobject.c \ + meson.build -include $(top_srcdir)/git.mk diff --git a/tests/gobject/docs/Makefile.am b/tests/gobject/docs/Makefile.am index bae229d..3c2eb7a 100644 --- a/tests/gobject/docs/Makefile.am +++ b/tests/gobject/docs/Makefile.am @@ -77,4 +77,8 @@ TESTS_ENVIRONMENT = \ PATH=$(abs_top_builddir):$(srcdir):$(PATH) endif +EXTRA_DIST += meson.build +EXTRA_DIST += images/meson.build +EXTRA_DIST += xml/meson.build + -include $(top_srcdir)/git.mk diff --git a/tests/gobject/docs/meson.build b/tests/gobject/docs/meson.build index be8c01c..a1dd66c 100644 --- a/tests/gobject/docs/meson.build +++ b/tests/gobject/docs/meson.build @@ -46,6 +46,22 @@ test( ], ) +sanitizer_args = [] + +if get_option('b_sanitize') == 'address' or get_option('b_sanitize') == 'address,undefined' + sanitizer_args += [ + '--extra-cflags=-fsanitize=address', + '--ldflags=-fsanitize=address', + ] +endif + +if get_option('b_sanitize') == 'undefined' or get_option('b_sanitize') == 'address,undefined' + sanitizer_args += [ + '--extra-cflags=-fsanitize=undefined', + '--ldflags=-fsanitize=undefined', + ] +endif + test( 'test-gobject-scangobj', python_prg, @@ -59,6 +75,9 @@ test( '--extra-pkg=@0@'.format('gobject-2.0'), '--extra-lib=@0@'.format(gobject_test_lib.full_path()), '--module=@0@'.format('tester'), + ] + sanitizer_args, + env: [ + 'ASAN_OPTIONS=detect_leaks=0', ], ) diff --git a/tests/gobject/src/Makefile.am b/tests/gobject/src/Makefile.am index a65fe01..2c13a0d 100644 --- a/tests/gobject/src/Makefile.am +++ b/tests/gobject/src/Makefile.am @@ -14,4 +14,6 @@ AM_CPPFLAGS = $(TEST_DEPS_CFLAGS) endif +EXTRA_DIST = meson.build + -include $(top_srcdir)/git.mk diff --git a/tests/mkdb.py b/tests/mkdb.py index d41bd8c..3f04fba 100755 --- a/tests/mkdb.py +++ b/tests/mkdb.py @@ -66,7 +66,35 @@ class ParseCommentBlock(ScanSourceContentTestCase): """).splitlines(keepends=True)) self.assertEqual({'symbol': 'Description.\n'}, mkdb.SourceSymbolDocs) + def test_FindsDocCommentForSignal(self): + mkdb.SourceSymbolDocs = {} + mkdb.ParseCommentBlock(textwrap.dedent("""\ + Class::signal-with-dashes: + + Description. + """).splitlines(keepends=True)) + self.assertEqual({'Class::signal-with-dashes': 'Description.\n'}, mkdb.SourceSymbolDocs) + + def test_FindsDocCommentForProperty(self): + mkdb.SourceSymbolDocs = {} + mkdb.ParseCommentBlock(textwrap.dedent("""\ + Class:property-with-dashes: + + Description. + """).splitlines(keepends=True)) + self.assertEqual({'Class:property-with-dashes': 'Description.\n'}, mkdb.SourceSymbolDocs) + + def test_FindsDocCommentForActions(self): + mkdb.SourceSymbolDocs = {} + mkdb.ParseCommentBlock(textwrap.dedent("""\ + Class|action.with.dots-and-dashes: + + Description. + """).splitlines(keepends=True)) + self.assertEqual({'Class|action.with.dots-and-dashes': 'Description.\n'}, mkdb.SourceSymbolDocs) + def test_FindsDocCommentWithParam(self): + mkdb.SourceSymbolDocs = {} mkdb.ParseCommentBlock(textwrap.dedent("""\ symbol: @par: value @@ -78,6 +106,7 @@ class ParseCommentBlock(ScanSourceContentTestCase): self.assertEqual({'par': 'value\n'}, mkdb.SourceSymbolParams['symbol']) def test_FindsDocCommentWithMultilineParam(self): + mkdb.SourceSymbolDocs = {} mkdb.ParseCommentBlock(textwrap.dedent("""\ symbol: @par: value docs with @@ -90,6 +119,7 @@ class ParseCommentBlock(ScanSourceContentTestCase): self.assertEqual({'par': 'value docs with\ntwo lines\n'}, mkdb.SourceSymbolParams['symbol']) def test_FindsDocCommentWithReturns(self): + mkdb.SourceSymbolDocs = {} mkdb.ParseCommentBlock(textwrap.dedent("""\ symbol: @@ -104,6 +134,7 @@ class ParseCommentBlock(ScanSourceContentTestCase): self.assertEqual({'Returns': ' result\n'}, mkdb.SourceSymbolParams['symbol']) def test_FindsDocCommentWithSince(self): + mkdb.SourceSymbolDocs = {} mkdb.ParseCommentBlock(textwrap.dedent("""\ symbol: @@ -113,6 +144,7 @@ class ParseCommentBlock(ScanSourceContentTestCase): self.assertEqual('0.1', mkdb.Since['symbol']) def test_FindsDocCommentWithDeprecated(self): + mkdb.SourceSymbolDocs = {} mkdb.ParseCommentBlock(textwrap.dedent("""\ symbol: @@ -123,6 +155,7 @@ class ParseCommentBlock(ScanSourceContentTestCase): self.assertEqual(' use function() instead\n', mkdb.Deprecated['symbol']) def test_FindsDocCommentWithStability(self): + mkdb.SourceSymbolDocs = {} mkdb.ParseCommentBlock(textwrap.dedent("""\ symbol: @@ -132,6 +165,7 @@ class ParseCommentBlock(ScanSourceContentTestCase): self.assertEqual('Stable', mkdb.StabilityLevel['symbol']) def test_HandlesHTMLEntities(self): + mkdb.SourceSymbolDocs = {} mkdb.ParseCommentBlock(textwrap.dedent("""\ symbol: diff --git a/tests/program/Makefile.am b/tests/program/Makefile.am index 1653011..1bd72fd 100644 --- a/tests/program/Makefile.am +++ b/tests/program/Makefile.am @@ -8,4 +8,6 @@ check-local: clean endif +EXTRA_DIST = meson.build + -include $(top_srcdir)/git.mk diff --git a/tests/program/docs/Makefile.am b/tests/program/docs/Makefile.am index 468c01c..e031c01 100644 --- a/tests/program/docs/Makefile.am +++ b/tests/program/docs/Makefile.am @@ -73,4 +73,7 @@ TESTS_ENVIRONMENT = \ PATH=$(abs_top_builddir):$(srcdir):$(PATH) endif +EXTRA_DIST += meson.build +EXTRA_DIST += xml/meson.build + -include $(top_srcdir)/git.mk diff --git a/tests/repro/Makefile.am b/tests/repro/Makefile.am index ad34ec6..1bd72fd 100644 --- a/tests/repro/Makefile.am +++ b/tests/repro/Makefile.am @@ -8,5 +8,6 @@ check-local: clean endif +EXTRA_DIST = meson.build -include $(top_srcdir)/git.mk diff --git a/tests/repro/docs/Makefile.am b/tests/repro/docs/Makefile.am index ed9bf2a..211332c 100644 --- a/tests/repro/docs/Makefile.am +++ b/tests/repro/docs/Makefile.am @@ -75,4 +75,6 @@ endif CLEANFILES += \ tester-sections.txt +EXTRA_DIST += meson.build + -include $(top_srcdir)/git.mk |