summaryrefslogtreecommitdiff
path: root/util
Commit message (Collapse)AuthorAgeFilesLines
* Add doxygen-extra.css, deprecate doxygen.cssKjell Ahlstedt2014-08-264-2/+275
| | | | | | | | | | | | | | | * README: Say that doxygen.css is deprecated. Add description of doxygen-extra.css. * Makefile.am: Distribute doxygen-extra.css. * build/doc-reference.am: Distribute doxygen-extra.css. * skeletonmm/.gitignore: Ignore doxygen-extra.css. * skeletonmm/doc/reference/Doxyfile.in: Use doxygen-extra.css instead of doxygen.css. * util/doxygen.css: Add comment, saying it's deprecated. * util/doxygen-extra.css: New file. Equal to doxygen.css except for comments. * util/mm-common-prepare.in: Copy doxygen-extra.css. * util/mm-common-prepare.1.in: List doxygen-extra.css. https://mail.gnome.org/archives/gtkmm-list/2014-August/msg00022.html
* Update for Doxygen 1.8.Kjell Ahlstedt2013-01-062-2/+11
| | | | | | | | | | * skeletonmm/doc/reference/Doxyfile.in: Update with Doxygen 1.8.3. doxygen -s -u Doxyfile.in * util/post-process.pl: Don't collapse almost all multiple spaces to a single space. It distorts the formatting of @code blocks, even more so with Doxygen 1.8. * util/doxygen.css: Add rules for div.fragment and div.line. Used for @code blocks by Doxygen 1.8.
* Set datarootdir in mm-common-util.pcKalev Lember2011-03-181-0/+1
| | | | | * util/mm-common-util.pc.in: Set the datarootdir variable now that the file is in ${datadir}/pkgconfig directory.
* Add mm-common-util.pc so we can get doc utils from mm-common.Murray Cumming2011-03-151-0/+9
| | | | | | | | | | | | | | | | | | | | * util/mm-common-util.pc.in: Added this file, with the path to the installed doctool/*.pl files. * configure.ac: * Makefile.am: Generate and install the .pc file. * macros/mm-doc.m4: Use the mm-common-util .pc file, not the glibmm-2.4 one. Previously, glibmm installed a copy that it got from mm-common-prepare and other modules then asked glibmm where to find its copy. That was probably for backwards compatibility. But we break stuff with gtkmm 3 anyway, so now is a good time to avoid the duplication by requiring modules to get it from mm-common instead. Actually this should only require a rerun of autogen.sh, because mm-common's own MM_CONFIG_DOCTOOL_DIR macro is what gets the path to these utils. Removing the hard-coding of glibmm-2.4 will also help us when we eventually break the glibmm ABI.
* Include friend members in Devhelp indexDaniel Elstner2010-01-061-2/+5
| | | | | | * util/tagfile-to-devhelp2.xsl (keyword-list): Treat kind "friend" as a synonym for kind "function", so that friend members are included in the Devhelp keyword list.
* Point to skeletonmm tar archive in manual pageDaniel Elstner2009-12-291-2/+2
| | | | | * util/mm-common-prepare.1.in: Adjust reference to the installed skeletonmm/ directory to point to the tar archive instead.
* Generate a nested hierarchy of Devhelp chaptersDaniel Elstner2009-09-271-29/+57
| | | | | | | | | | | | * util/tagfile-to-devhelp2.xsl (chapters): Turn the flat structure of the Doxygen tag file into hierarchies of modules and classes. At the top-level, select only those compounds which are not a member of any other compound, and then process the nested compounds recursively to create the tree structure. (functions): Refactor and canonicalize the template logic. No longer attempt to sort the keyword list, because it is not a requirement and unnecessarily complicates the transformation. (xsl:strip-space): Strip excess whitespace from source elements.
* Correct conditional generation of Devhelp chaptersDaniel Elstner2009-09-211-20/+12
| | | | | | | | * util/tagfile-to-devhelp2.xsl (chapters): Assign node sets to the intermediate variables using the select attribute, rather than trying to apply the templates in the element content. With this change, the test whether there are any child elements now correctly evaluates to false if the node set is empty.
* Handle filename argument to mm-common-prepareDaniel Elstner2009-09-171-12/+18
| | | | | | | * util/mm-common-prepare.in: Allow the name of the Autoconf source file to be specified on the command-line, so that it works the same way as with autoreconf. Also, create the directory for the auxiliary build files automatically if it does not exist.
* Treat whitespace in glob patterns literallyDaniel Elstner2009-09-112-2/+4
| | | | | | | * util/doc-{install,postprocess}.pl: Explicitly call the bsd_glob() subroutine instead of the builtin glob() function. Although the builtin glob() is implemented in terms of bsd_glob(), it additionally splits its argument into multiple patterns separated by whitespace.
* Increase space between Doxygen member descriptionsDaniel Elstner2009-09-091-1/+1
| | | | * util/doxygen.css (.memitem): Increase horizontal margins to 0.5em.
* Document source directory argument in manpageDaniel Elstner2009-09-081-10/+17
| | | | | | * util/mm-common-prepare.1.in: Substitute SOURCE-DIR for DIRECTORY. Document the purpose of the SOURCE-DIR argument. Insert line breaks after sentences as recommended by a manual page style guide.
* Substitute variables in the manpage at build timeDaniel Elstner2009-09-081-1/+7
| | | | | | | | | | * util/mm-common-prepare.1.in: Rename file from mm-common-prepare.1 and insert placeholders for the location of the documentation files. * Makefile.am (man1_MANS): Remove "dist_" prefix from variable name. (dist_noinst_DATA): Distribute util/mm-common-prepare.1.in file. (CLEANFILES): Clean generated util/mm-common-prepare.1 file. (util/mm-common-prepare.1): New rule to generate the manual page at build time.
* Create manual page for mm-common-prepareDaniel Elstner2009-09-081-0/+87
| | | | | | * util/mm-common-prepare.1: New manual page for the mm-common-prepare utility. * Makefile.am (dist_man1_MANS): Install mm-common-prepare manual page.
* Create Devhelp chapters only for existing contentDaniel Elstner2009-09-031-6/+23
| | | | | | | * util/tagfile-to-devhelp2.xsl (chapters): Output the <sub> elements only if they will have at least one child node. This way, there will be no broken chapter link in the Devhelp documentation if the module does not define any Doxygen groups, for instance.
* Hide the navigation path generated by DoxygenDaniel Elstner2009-09-031-0/+4
| | | | * util/doxygen.css (.navpath): Set 'display' to 'none'.
* Avoid using pixels as a unit in the style sheetDaniel Elstner2009-09-031-39/+35
| | | | | * util/doxygen.css: Use unit 'em' instead of 'px' where feasible. Merge or split blocks where appropriate to streamline the CSS.
* Increase the default font size to 90%Daniel Elstner2009-09-021-1/+1
| | | | | * util/doxygen.css (body): Change the font height and line spacing to 90%/150% in order to better match the default appearance of gtk-doc.
* Reduce duplicate logic in the Devhelp transformDaniel Elstner2009-09-021-4/+6
| | | | | | * util/tagfile-to-devhelp2.xsl (functions): Apply the templates to all <compound> elements, and add a catch-all template to filter anything which did not match.
* Show Doxygen groups as modules in DevhelpDaniel Elstner2009-09-021-3/+12
| | | | | * util/tagfile-to-devhelp2.xsl (chapters): Add "Modules" chapter and list all compounds of kind "group" there.
* Do not extract keywords from Doxygen groupsDaniel Elstner2009-09-021-3/+12
| | | | | | | | * util/tagfile-to-devhelp2.xsl (functions): Only list members of compounds which correspond to a C++ language construct, i.e. a class or a namespace. Other Doxygen compounds like groups or files do not exist at the language level, and their names should not be used like namespace prefixes.
* Concatenate the destination path only when neededDaniel Elstner2009-09-021-1/+1
| | | | | * util/doc-install.pl: Move the assignment to $out_file into the conditional block where it is actually used.
* Limit centering of HTML headings to first headingDaniel Elstner2009-08-311-4/+2
| | | | | | * util/doxygen.css (h[23]): Remove "text-align: center" attribute. (h1 + h3): Center a <h3> element immediately following the centered <h1> element, as generated by Doxygen on the main page.
* Do not center HTML headings within tablesDaniel Elstner2009-08-311-0/+4
| | | | | * util/doxygen.css (table h[23]): Set "text-align" to "left" for <h2> and <h3> tags with a <table> ancestor.
* Update style sheet for XHTML output of Doxygen 1.6Daniel Elstner2009-08-311-5/+18
| | | | | | * util/doxygen.css: Refine style definitions to cope with the change in behavior of user agents due to Doxygen's recent adoption of XHTML as default output format.
* Improve Doxygen HTML style sheetDaniel Elstner2009-08-281-21/+10
| | | | | * util/doxygen.css: Tweak the styles a bit to improve the look of the Doxygen HTML output. Most importantly, get the text size right.
* Add shared Doxygen stylesheet for the C++ bindingsDaniel Elstner2009-08-272-1/+246
| | | | | | | | * util/doxygen.css: New file, defining the common style of the C++ binding reference documentation. * util/mm-common-prepare.in: Copy doxygen.css into the documentation tools directory of the source tree if requested. * Makefile.am (dist_doctool_DATA): Distribute and install doxygen.css.
* Add missing backslash escapeDaniel Elstner2009-08-211-1/+1
| | | | | | * util/mm-common-prepare.in: Insert a missing backslash to escape another backslash within a double-quoted sed script. Apparently it accidentally worked even without proper escaping.
* Turn doc-postprocess.pl into a good Unix citizenDaniel Elstner2009-08-191-15/+54
| | | | | | | * util/doc-postprocess.pl: Implement rudimentary error reporting and minimal command-line option handling, so that at least --help works. Also, refine some of the substitutions performed and add new ones to translate entity references to numerical code points.
* Switch back from Autoconf tracing to sedDaniel Elstner2009-08-101-10/+4
| | | | | | | * util/mm-common-prepare.in: Go back to the old method of using the sed stream editor to extract the macro arguments from configure.ac. Unfortunately, it turns out that Autoconf tracing fails to extract the arguments of custom macros when building from a clean tree.
* Make mm-common-prepare copy doc tools on requestDaniel Elstner2009-08-101-4/+29
| | | | | | | | | | | | * Makefile.am (dist_doctool_DATA): Install documentation utilities to the $(pkgdatadir)/doctool directory. * macros/mm-doc.m4 (MM_CONFIG_DOCTOOL_DIR): New Autoconf macro for locating the documentation utilities. Either a local directory in the source tree can be used, or alternatively pkg-config will be invoked and request the install location from the glibmm-2.4 module. * util/mm-common-prepare.in: Scan configure.ac for calls to the new MM_CONFIG_DOCTOOL_DIR() macro. If a local directory name was given, copy the documentation utilities into the source tree.
* Implement filename globbing within doc-install.plDaniel Elstner2009-08-092-7/+21
| | | | | | | | | | | | | | | | | | | | | | | | | | | | * util/doc-install.pl: Add a new --glob flag, which tells the script to interpret the source arguments as glob patterns instead of literal filenames. Performing the filename glob expansion internally avoids excessively long argument lists, which can unfortunately be a problem with some platforms. Also, remember the basename of every installed file, and use that information to skip over files whose basename has already been seen. * util/doc-postprocess.pl: Also perform globbing internally to avoid excessively long command lines. * build/doc-reference.am (MMDOCTOOLDIR): Use this separate variable instead of GMMPROC_DIR for the default location of the documentation utility scripts. (doc_postprocess), (doc_install), (tagfile_to_devhelp2): Derive default values from $(MMDOCTOOLDIR). Include the interpreter command $(PERL) as part of the variable value, just in case someone needs to override the Perl interpreter as well. (install-data-local): Use the new --glob feature of doc-install.pl instead of having make expand the entire list of filenames into the shell command-line. (uninstall-local): Do not rely on globbing at the shell level for producing the list of files to delete, since it would probably exceed the command line length limits of some platforms. Do not go back to rm -rf either, but use a combination of 'find' and 'rm -f' to restrict the deletion to those files that match the same glob pattern as the one used to select the files to install.
* Query auxiliary directory via Autoconf trace modeDaniel Elstner2009-08-091-6/+6
| | | | | | * util/mm-common-prepare.in: Instead of using a sed program to parse configure.ac manually, invoke Autoconf in trace mode to collect the first argument to the AC_CONFIG_AUX_DIR() macro.
* Fix handling of mm-common-prepare --forceDaniel Elstner2009-08-081-14/+18
| | | | | | | | * util/mm-common-prepare.in: Simply check whether $forceflag is empty instead of doing a string comparison and getting it wrong. Also, for improved robustness, use a fixed list of files to install instead of a wildcard pattern. Make the sed expression to extract the auxiliary build directory skip over both spaces and tabs.
* Fix typo in shell parameter substitutionDaniel Elstner2009-08-061-2/+2
| | | | * util/mm-common-prepare.in (progname): It's ${0##*/}, not ${0##/*}.
* Create mm-common moduleDaniel Elstner2009-08-044-0/+456