| Commit message (Collapse) | Author | Age | Files | Lines |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
* 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
|
|
|
|
|
|
|
|
|
|
| |
* 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.
|
|
|
|
|
| |
* util/mm-common-util.pc.in: Set the datarootdir variable now that the
file is in ${datadir}/pkgconfig directory.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
* 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.
|
|
|
|
|
|
| |
* 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.
|
|
|
|
|
| |
* util/mm-common-prepare.1.in: Adjust reference to the installed
skeletonmm/ directory to point to the tar archive instead.
|
|
|
|
|
|
|
|
|
|
|
|
| |
* 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.
|
|
|
|
|
|
|
|
| |
* 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.
|
|
|
|
|
|
|
| |
* 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.
|
|
|
|
|
|
|
| |
* 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.
|
|
|
|
| |
* util/doxygen.css (.memitem): Increase horizontal margins to 0.5em.
|
|
|
|
|
|
| |
* 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.
|
|
|
|
|
|
|
|
|
|
| |
* 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.
|
|
|
|
|
|
| |
* 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.
|
|
|
|
|
|
|
| |
* 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.
|
|
|
|
| |
* util/doxygen.css (.navpath): Set 'display' to 'none'.
|
|
|
|
|
| |
* util/doxygen.css: Use unit 'em' instead of 'px' where feasible.
Merge or split blocks where appropriate to streamline the CSS.
|
|
|
|
|
| |
* 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.
|
|
|
|
|
|
| |
* 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.
|
|
|
|
|
| |
* util/tagfile-to-devhelp2.xsl (chapters): Add "Modules" chapter and
list all compounds of kind "group" there.
|
|
|
|
|
|
|
|
| |
* 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.
|
|
|
|
|
| |
* util/doc-install.pl: Move the assignment to $out_file into the
conditional block where it is actually used.
|
|
|
|
|
|
| |
* 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.
|
|
|
|
|
| |
* util/doxygen.css (table h[23]): Set "text-align" to "left" for <h2>
and <h3> tags with a <table> ancestor.
|
|
|
|
|
|
| |
* 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.
|
|
|
|
|
| |
* util/doxygen.css: Tweak the styles a bit to improve the look of the
Doxygen HTML output. Most importantly, get the text size right.
|
|
|
|
|
|
|
|
| |
* 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.
|
|
|
|
|
|
| |
* 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.
|
|
|
|
|
|
|
| |
* 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.
|
|
|
|
|
|
|
| |
* 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.
|
|
|
|
|
|
|
|
|
|
|
|
| |
* 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.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
* 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.
|
|
|
|
|
|
| |
* 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.
|
|
|
|
|
|
|
|
| |
* 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.
|
|
|
|
| |
* util/mm-common-prepare.in (progname): It's ${0##*/}, not ${0##/*}.
|
|
|