From: Alistair Thomas Date: Fri, 3 Mar 2017 19:11:24 +0000 (+0000) Subject: manual: Add version information and copyright to manual X-Git-Tag: 0.35.90~10 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=5d846a2cc6ad11c1f931b682d7d67f49e07c9043;p=thirdparty%2Fvala.git manual: Add version information and copyright to manual The documentation is downloaded from the GNOME wiki. So the same copyright notice is used. The wiki states (c) The GNOME Project at the bottom of each page. The license for all new documentation is CC-BY-SA 4.0. See https://wiki.gnome.org/DocumentationProject/Guide/Licensing --- diff --git a/configure.ac b/configure.ac index 67d649ce9..030957e46 100644 --- a/configure.ac +++ b/configure.ac @@ -113,6 +113,7 @@ AC_CONFIG_FILES([Makefile tests/Makefile doc/Makefile doc/manual/Makefile + doc/manual/version.xml gobject-introspection/Makefile vapigen/vapigen.pc vapigen/Makefile diff --git a/doc/manual/.gitignore b/doc/manual/.gitignore index 34a65b647..944f5eeea 100644 --- a/doc/manual/.gitignore +++ b/doc/manual/.gitignore @@ -1,2 +1,3 @@ +version.xml html/ devhelp/ diff --git a/doc/manual/Makefile.am b/doc/manual/Makefile.am index 7a26f2670..08ec8182b 100644 --- a/doc/manual/Makefile.am +++ b/doc/manual/Makefile.am @@ -11,26 +11,25 @@ book_DATA = \ endif $(builddir)/devhelp/*: devhelp -devhelp: manual.xml devhelp.xsl xhtml.xsl +devhelp: manual.xml version.xml devhelp.xsl xhtml.xsl @$(MKDIR_P) $@ $(AM_V_GEN)$(XSLTPROC) \ - --xinclude $(srcdir)/devhelp.xsl \ - $(srcdir)/manual.xml \ - > $(builddir)/devhelp/$(BOOK_NAME).devhelp2 + --xinclude \ + --output $@/$(BOOK_NAME).devhelp2 \ + $(srcdir)/devhelp.xsl \ + $(srcdir)/manual.xml @$(XSLTPROC) \ --xinclude \ - --stringparam outdir $@ \ --output $@/index.html \ $(srcdir)/xhtml.xsl \ $(srcdir)/manual.xml @cp $(srcdir)/default.css $@ @touch $@ -html: manual.xml xhtml.xsl +html: manual.xml version.xml xhtml.xsl @$(MKDIR_P) $@ $(AM_V_GEN)$(XSLTPROC) \ --xinclude \ - --stringparam outdir $@ \ --output $@/index.html \ $(srcdir)/xhtml.xsl \ $(srcdir)/manual.xml @@ -41,6 +40,10 @@ mostlyclean-local: rm -rf devhelp rm -rf html +CLEANFILES = \ + version.xml \ + $(NULL) + EXTRA_DIST = \ common.xsl \ default.css \ diff --git a/doc/manual/default.css b/doc/manual/default.css index ee76427f9..3c432ccb4 100644 --- a/doc/manual/default.css +++ b/doc/manual/default.css @@ -120,6 +120,14 @@ pre { white-space: pre-wrap; } +.c-document_version { border: solid 2px #ccc; + border-radius: 4px; + width: 100%; + font-sizde: 95%; +} +.c-document_version tr td:first-child { text-align: right; } +.c-document_version tr:nth-child(odd) { background-color: #f0f0f0; } + blockquote span.literal { font-family: monospace; font-weight: bold; diff --git a/doc/manual/version.xml.in b/doc/manual/version.xml.in new file mode 100644 index 000000000..e89676864 --- /dev/null +++ b/doc/manual/version.xml.in @@ -0,0 +1,15 @@ + + + + +The Vala programming language is a high level language that produces binaries for the native platform. The binaries maintain the C Application Binary Interface (ABI) and so can be built as either an application or a library. +The Vala Reference Manual gives details on Vala's syntax and type system, including polymorphism using interfaces and type parameters (generics). Vala includes additional code generation routines, for example D-Bus inter-process communication and GTK+3 composite templates, these are only referred to in the Attributes section. The reference manual does not provide a tutorial for these features. +Vala is developed in a collaborative and self-supporting way by its users. They provide bug reports, documentation, patches, patch reviews and core development. Following this model of development the manual has an editable version at https://wiki.gnome.org/Projects/Vala/Manual . + +@PACKAGE_SUFFIX@ +@VERSION@ +Draft, document contains omissions and might contain errors + +The GNOME Project +Creative Commons Attribution-ShareAlike 4.0 International + diff --git a/doc/manual/xhtml.xsl b/doc/manual/xhtml.xsl index 43420bc32..97338467c 100644 --- a/doc/manual/xhtml.xsl +++ b/doc/manual/xhtml.xsl @@ -4,8 +4,9 @@ version="1.0" xmlns:str="http://exslt.org/strings" xmlns:exsl="http://exslt.org/common" + xmlns:date="http://exslt.org/dates-and-times" extension-element-prefixes="exsl" - exclude-result-prefixes="str" + exclude-result-prefixes="str date" > @@ -104,6 +105,7 @@ +
  • @@ -131,6 +133,24 @@ + + + + + + + + + + +
    Vala version:
    Release:
    Status:
    Copyright: + © + + + +
    License:
    +     +