delta/NetworkManager.git/docs, branch th/NMStringTable

libnm-util, libnm-glib: add versioned deprecation/availability macros

2014-02-13T16:24:37+00:00

Add versioned NM_DEPRECATED_IN_* and NM_AVAILABLE_IN_* macros, and tag
new/deprecated functions accordingly. (All currently-deprecated
functions are assumed to have been deprecated in 0.9.10.)

Add NM_VERSION_MIN_REQUIRED and NM_VERSION_MAX_ALLOWED macros which
can be set to determine which versions will cause warnings.

With the current settings, external consumers of the
libnm-util/libnm-glib APIs will have MIN_REQUIRED and MAX_ALLOWED both
set to NM_VERSION_0_9_8 by default, meaning they will get warnings
about functions added in 0.9.10. NM internally sets
NM_VERSION_MAX_ALLOWED to NM_VERSION_NEXT_STABLE to ensure that it is
always allowed to use all APIs.

docs: update documentation links

2013-12-17T18:07:51+00:00

Various GNOME services moved around so links need updating.

docs: update for Team and Generic devices

2013-11-07T22:58:29+00:00

libnm-util: add Data Center Bridging (DCB) setting

2013-10-31T18:28:42+00:00

Includes various fixes & cleanups from Thomas Haller.

Fix typos

2013-10-19T15:49:18+00:00

https://bugzilla.gnome.org/show_bug.cgi?id=710505

build: fix builddir != srcdir when building D-Bus API spec HTML

2013-08-29T18:43:03+00:00

build: always generate docs at dist time (bgo #700093)

2013-05-14T15:53:46+00:00

dist tarballs shouldn't ever be released without the documentation,
and this allows us to build the tarballs with pre-generated docs
that get installed on the end system, but don't need to be built
there.  So the end system doesn't need gtk-doc installed, only
the dist system does.

https://bugzilla.gnome.org/show_bug.cgi?id=700093

build: fix build with --enable-doc (docs/api/Makefile.am)

2013-02-12T16:25:20+00:00

"./autogen.sh --enable-doc && make" produced this error:
warning: failed to load external entity "../settings-spec.xml"
../network-manager-docs.xml:57: element include: XInclude error : could not load ../settings-spec.xml, and no fallback was found

Removing settings-spec.xml from $(content_files) made the file non-DISTed but it
also removed the file as a dependency for html-build.stamp that also runs
cd html && gtkdoc-mkhtml $$mkhtml_options $(MKHTML_OPTIONS) $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE)
and $(DOC_MAIN_SGML_FILE) includes settings-spec.xml.

Fix that by making $(DOC_MAIN_SGML_FILE) dependent on setting-spec.xml.

build: fix distcheck when building settings specification XML

2013-02-05T21:26:05+00:00

The generated settings-spec.xml should not be DIST-ed because it's
regenerated every time libnm-util changes.  That meants it gets
rebuilt during 'make' even from a dist tarball.  Thus, it shouldn't
be part of the dist tarball itself.

In addition, settings-spec.html shouldn't be included in
$(content_files) becuase this is added to EXTRA_DIST by gtk-doc.make.

Since generate-settings-spec.c the move from docs/api/ to tools/,
this started breaking distcheck even though the original Makefile
rules were wrong too.

tools: move generate-settings-spec to tools

2013-02-05T17:25:03+00:00