diff options
author | Rico Tzschichholz <ricotz@ubuntu.com> | 2017-03-05 18:00:40 +0100 |
---|---|---|
committer | Rico Tzschichholz <ricotz@ubuntu.com> | 2017-03-07 09:26:14 +0100 |
commit | 4dda52ae5e94ca0d277b75f340b97a35c8a7a14e (patch) | |
tree | a6c17577fceb77ba28a8d804e1aab0b3ca5b4128 | |
parent | 19e0bea725f27b47f53090dcc83378e5345dce60 (diff) | |
download | vala-4dda52ae5e94ca0d277b75f340b97a35c8a7a14e.tar.gz |
docs: Generate and update manpages
-rw-r--r-- | configure.ac | 3 | ||||
-rw-r--r-- | doc/Makefile.am | 29 | ||||
-rw-r--r-- | doc/vala-gen-introspect.1 | 52 | ||||
-rw-r--r-- | doc/vala-gen-introspect.h2m | 32 | ||||
-rw-r--r-- | doc/valac.1 | 175 | ||||
-rw-r--r-- | doc/valac.h2m | 31 | ||||
-rw-r--r-- | doc/vapigen.1 | 81 | ||||
-rw-r--r-- | doc/vapigen.h2m | 30 |
8 files changed, 302 insertions, 131 deletions
diff --git a/configure.ac b/configure.ac index 112a74ace..358a0ac8f 100644 --- a/configure.ac +++ b/configure.ac @@ -92,6 +92,9 @@ AC_SUBST(GTHREAD_LIBS) AC_PATH_PROG([XSLTPROC], [xsltproc], :) AM_CONDITIONAL(HAVE_XSLTPROC, test "$XSLTPROC" != :) +AC_CHECK_PROG([HELP2MAN], [help2man], [help2man]) +AM_CONDITIONAL([HAVE_HELP2MAN], [test x$HELP2MAN = xhelp2man]) + m4_ifdef([AM_SILENT_RULES],[AM_SILENT_RULES([yes])]) AC_CONFIG_FILES([Makefile diff --git a/doc/Makefile.am b/doc/Makefile.am index 58ba20594..edf613996 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -10,6 +10,35 @@ dist_man_MANS = \ vapigen.1 \ $(NULL) +EXTRA_DIST = \ + valac.h2m \ + vala-gen-introspect.h2m \ + vapigen.h2m \ + $(NULL) + +if HAVE_HELP2MAN +manpages: valac.1 vala-gen-introspect.1 vapigen.1 + @rm $^ + $(MAKE) $(AM_MAKEFLAGS) $^ + +valac.1: + $(HELP2MAN) $(top_builddir)/compiler/valac \ + --include $(srcdir)/valac.h2m \ + --libtool --no-info \ + --output=$@ +vala-gen-introspect.1: + $(HELP2MAN) $(top_builddir)/gobject-introspection/gen-introspect \ + --include $(srcdir)/vala-gen-introspect.h2m \ + --version-string=$(PACKAGE_VERSION) \ + --libtool --no-info \ + --output=$@ +vapigen.1: + $(HELP2MAN) $(top_builddir)/vapigen/vapigen \ + --include $(srcdir)/vapigen.h2m \ + --libtool --no-info \ + --output=$@ +endif + if ENABLE_UNVERSIONED install-data-hook: cd $(DESTDIR)$(man1dir) && $(LN_S) -f valac@PACKAGE_SUFFIX@.1 valac.1 diff --git a/doc/vala-gen-introspect.1 b/doc/vala-gen-introspect.1 index 68052d96a..15d990690 100644 --- a/doc/vala-gen-introspect.1 +++ b/doc/vala-gen-introspect.1 @@ -1,10 +1,9 @@ -.TH vala-gen-introspect 1 "26 October 2007" "vala-0.1.5" "Vala" -.IX vala-gen-introspect +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.4. +.TH VALA-GEN-INTROSPECT "1" "March 2017" "vala-gen-introspect 0.34.6" "User Commands" .SH NAME vala-gen-introspect \- generate a GI file for GObject and glib based packages .SH SYNOPSIS .B vala-gen-introspect \fIPKGNAME\fP \fIPKGBASE\fP - .SH DESCRIPTION .B vala-gen-introspect is a utility which generates GI files from GObject and glib @@ -12,21 +11,40 @@ based packages. It can be used in combination with vapigen(1) to generate an API for Vala, and allow it's usage in Vala for compiling to native code. \fIPKGNAME\fP is the pkg-config name of the library and \fIPKGBASE\fP specifies the base directory for that package. - -.SH EXAMPLES +.SS "Usage:" +.IP +gen\-introspect [OPTION?] +.SS "Help Options:" +.TP +\fB\-h\fR, \fB\-\-help\fR +Show help options +.SS "Application Options:" +.TP +\fB\-v\fR, \fB\-\-verbose\fR +Be verbose +.TP +\fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR +write output here instead of stdout .TP +\fB\-n\fR, \fB\-\-namespace\fR=\fI\,NAMESPACE\/\fR +Namespace of the module, like 'Gtk' +.TP +\fB\-\-shared\-library\fR=\fI\,FILE\/\fR +Shared library which contains the symbols +.TP +\fB\-\-include\-idl\fR=\fI\,IDL\/\fR +Other gidls to include +.SH BUGS +https://bugzilla.gnome.org/page.cgi?id=browse.html&product=vala +.SH "HOMEPAGE OR CONTACT" +https://wiki.gnome.org/Projects/Vala +.SH AUTHORS +J??rg Billeter <j@bitron.ch>, Raffaele Sandrini <rasa@gmx.ch> +.SH EXAMPLES After compilation, the following command generates a GI for pango: .B vala-gen-introspect pango packages/pango - -.SH OPTIONS .TP -This command currently takes no command line options. -.SH SEE ALSO -.BR vapigen (1) - -.SH AUTHOR -vala-gen-introspect for Vala was written by Juerg Billeter <j@bitron.ch> and -Raffaele Sandrini <rasa@gmx.ch>. -.PP -This manual page was written by Kumar Appaiah <akumar@ee.iitm.ac.in>, -for the Debian project (but may be used by others). +This can then be converted to a Vala API as follows: +.B vapigen --pkg cairo --vapidir . --library pango packages/pango/pango.gi +.SH "SEE ALSO" +vapigen (1) diff --git a/doc/vala-gen-introspect.h2m b/doc/vala-gen-introspect.h2m new file mode 100644 index 000000000..b409e4e03 --- /dev/null +++ b/doc/vala-gen-introspect.h2m @@ -0,0 +1,32 @@ +[NAME] +vala-gen-introspect \- generate a GI file for GObject and glib based packages + +[SYNOPSIS] +.B vala-gen-introspect \fIPKGNAME\fP \fIPKGBASE\fP + +[DESCRIPTION] +.B vala-gen-introspect +is a utility which generates GI files from GObject and glib +based packages. It can be used in combination with vapigen(1) to +generate an API for Vala, and allow it's usage in Vala for compiling +to native code. \fIPKGNAME\fP is the pkg-config name of the library +and \fIPKGBASE\fP specifies the base directory for that package. + +[EXAMPLES] +After compilation, the following command generates a GI for pango: +.B vala-gen-introspect pango packages/pango +.TP +This can then be converted to a Vala API as follows: +.B vapigen --pkg cairo --vapidir . --library pango packages/pango/pango.gi + +[BUGS] +https://bugzilla.gnome.org/page.cgi?id=browse.html&product=vala + +[HOMEPAGE or CONTACT] +https://wiki.gnome.org/Projects/Vala + +[SEE ALSO] +vapigen (1) + +[AUTHORS] +Jürg Billeter <j@bitron.ch>, Raffaele Sandrini <rasa@gmx.ch> diff --git a/doc/valac.1 b/doc/valac.1 index 2d3f70b23..7bbcc6538 100644 --- a/doc/valac.1 +++ b/doc/valac.1 @@ -1,168 +1,197 @@ -.TH valac 1 "13 April 2010" "vala-0.8.0" "Vala" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.4. +.TH VALAC "1" "March 2017" "valac 0.34.6" "User Commands" .SH NAME valac \- compiler that translates Vala source code into C source and header files .SH SYNOPSIS .B valac [\fIOPTION\fR]... [\fIFILE\fR]... .SH DESCRIPTION -Vala is a new programming language that aims to bring modern +Vala is a programming language that aims to bring modern programming language features to GNOME developers without imposing any additional runtime requirements and without using a different ABI compared to applications and libraries written in C. - +.TP valac, the Vala compiler, is a self-hosting compiler that translates Vala source code into C source and header files. It uses the GObject type system to create classes and interfaces declared in the Vala source code. -.SH OPTIONS +.SS "Usage:" +.IP +valac [OPTION?] FILE... \- Vala Compiler +.SS "Help Options:" .TP -.B \--help +\-?, \fB\-\-help\fR +Show help options +.SS "Application Options:" .TP -.B \--vapidir=\fIDIRECTORY\fR... -Look for package bindings in \fIDIRECTORY\fR +\fB\-\-vapidir\fR=\fI\,DIRECTORY\/\fR... +Look for package bindings in DIRECTORY .TP -.B \--girdir=\fIDIRECTORY\fR... -Look for .gir files in \fIDIRECTORY\fR +\fB\-\-girdir\fR=\fI\,DIRECTORY\/\fR... +Look for .gir files in DIRECTORY .TP -.B \--metadatadir=\fIDIRECTORY\fR... -Look for GIR .metadata files in \fIDIRECTORY\fR +\fB\-\-metadatadir\fR=\fI\,DIRECTORY\/\fR... +Look for GIR .metadata files in DIRECTORY .TP -.B \--pkg=\fIPACKAGE\fR... -Include binding for \fIPACKAGE\fR +\fB\-\-pkg\fR=\fI\,PACKAGE\/\fR... +Include binding for PACKAGE .TP -.B \--vapi=\fIFILE\fR +\fB\-\-vapi\fR=\fI\,FILE\/\fR Output VAPI file name .TP -.B \--library=\fINAME\fR +\fB\-\-library\fR=\fI\,NAME\/\fR Library name .TP -.B \--shared-library=\fINAME\fR -Shared library name used in generated .gir -.TP -.B \--gir=\fINAME\fR-\fIVERSION\fR.gir -GObject-Introspection repository file name +\fB\-\-shared\-library\fR=\fI\,NAME\/\fR +Shared library name used in generated gir .TP -.B \--gresources=\fIFILE\fR... -GResources XML file name +\fB\-\-gir\fR=\fI\,NAME\-VERSION\/\fR.gir +GObject\-Introspection repository file name .TP -.B \-b, --basedir=\fIDIRECTORY\fR +\fB\-b\fR, \fB\-\-basedir\fR=\fI\,DIRECTORY\/\fR Base source directory .TP -.B \-d, --directory=\fIDIRECTORY\fR +\fB\-d\fR, \fB\-\-directory\fR=\fI\,DIRECTORY\/\fR Output directory .TP -.B \--version +\fB\-\-version\fR Display version number .TP -.B \--api-version +\fB\-\-api\-version\fR Display API version number .TP -.B \-C, --ccode +\fB\-C\fR, \fB\-\-ccode\fR Output C code .TP -.B \-H, --header=\fIFILE\fR +\fB\-H\fR, \fB\-\-header\fR=\fI\,FILE\/\fR Output C header file .TP -.B \--use-header +\fB\-\-use\-header\fR Use C header file .TP -.B \--includedir=\fIDIRECTORY\fR +\fB\-\-includedir\fR=\fI\,DIRECTORY\/\fR Directory used to include the C header file .TP -.B \-h, --internal-header=\fIFILE\fR +\fB\-h\fR, \fB\-\-internal\-header\fR=\fI\,FILE\/\fR Output internal C header file .TP -.B \--internal-vapi=\fIFILE\fR +\fB\-\-internal\-vapi\fR=\fI\,FILE\/\fR Output vapi with internal api .TP -.B \--symbols=\fIFILE\fR +\fB\-\-fast\-vapi\fR +Output vapi without performing symbol resolution +.TP +\fB\-\-use\-fast\-vapi\fR +Use \fB\-\-fast\-vapi\fR output during this compile +.TP +\fB\-\-vapi\-comments\fR +Include comments in generated vapi +.TP +\fB\-\-deps\fR +Write make\-style dependency information to this file +.TP +\fB\-\-symbols\fR=\fI\,FILE\/\fR Output symbols file .TP -.B \-c, --compile +\fB\-c\fR, \fB\-\-compile\fR Compile but do not link .TP -.B \-o, --output=\fIFILE\fR -Place output in file \fIFILE\fR +\fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR +Place output in file FILE .TP -.B \-g, --debug +\fB\-g\fR, \fB\-\-debug\fR Produce debug information .TP -.B \--thread +\fB\-\-thread\fR Enable multithreading support .TP -.B \--enable-mem-profiler +\fB\-\-enable\-mem\-profiler\fR Enable GLib memory profiler .TP -.B \-D, --define=SYMBOL... +\fB\-D\fR, \fB\-\-define\fR=\fI\,SYMBOL\/\fR... Define SYMBOL .TP -.B \--main=SYMBOL... +\fB\-\-main\fR=\fI\,SYMBOL\/\fR... Use SYMBOL as entry point .TP -.B \--nostdpkg +\fB\-\-nostdpkg\fR Do not include standard packages .TP -.B \--disable-assert +\fB\-\-disable\-assert\fR Disable assertions .TP -.B \--enable-checking -Enable additional run-time checks +\fB\-\-enable\-checking\fR +Enable additional run\-time checks .TP -.B \--enable-deprecated +\fB\-\-enable\-deprecated\fR Enable deprecated features .TP -.B \--enable-experimental +\fB\-\-hide\-internal\fR +Hide symbols marked as internal +.TP +\fB\-\-enable\-experimental\fR Enable experimental features .TP -.B \--disable-warnings +\fB\-\-disable\-warnings\fR Disable warnings .TP -.B \--fatal-warnings +\fB\-\-fatal\-warnings\fR Treat warnings as fatal .TP -.B \--enable-experimental-non-null -Enable experimental enhancements for non-null types +\fB\-\-disable\-since\-check\fR +Do not check whether used symbols exist in local packages +.TP +\fB\-\-enable\-experimental\-non\-null\fR +Enable experimental enhancements for non\-null types .TP -.B \--cc=\fICOMMAND\fR -Use \fICOMMAND\fR as C compiler command +\fB\-\-enable\-gobject\-tracing\fR +Enable GObject creation tracing .TP -.B \-X, --Xcc=\fIOPTION\fR... -Pass \fIOPTION\fR. to the C compiler +\fB\-\-cc\fR=\fI\,COMMAND\/\fR +Use COMMAND as C compiler command .TP -.B \--dump-tree=\fIFILE\fR -Write code tree to \fIFILE\fR +\fB\-X\fR, \fB\-\-Xcc\fR=\fI\,OPTION\/\fR... +Pass OPTION to the C compiler .TP -.B \--save-temps +\fB\-\-pkg\-config\fR=\fI\,COMMAND\/\fR +Use COMMAND as pkg\-config command +.TP +\fB\-\-dump\-tree\fR=\fI\,FILE\/\fR +Write code tree to FILE +.TP +\fB\-\-save\-temps\fR Keep temporary files .TP -.B \--profile=\fIPROFILE\fR +\fB\-\-profile\fR=\fI\,PROFILE\/\fR Use the given profile instead of the default .TP -.B \--no-color -Disable colored output -.TP -.B \-q, --quiet +\fB\-q\fR, \fB\-\-quiet\fR Do not print messages to the console .TP -.B \-v, --verbose +\fB\-v\fR, \fB\-\-verbose\fR Print additional messages to the console .TP -.B \--target-glib=\fIMAJOR\fR.\fIMINOR\fR +\fB\-\-no\-color\fR +Disable colored output +.TP +\fB\-\-target\-glib\fR=\fI\,MAJOR\/\fR.MINOR Target version of glib for code generation .TP -.B \--enable-version-header +\fB\-\-gresources\fR=\fI\,FILE\/\fR... +XML of gresources +.TP +\fB\-\-enable\-version\-header\fR Write vala build version in generated files .TP -.B \--disable-version-header +\fB\-\-disable\-version\-header\fR Do not write vala build version in generated files +.SH BUGS +https://bugzilla.gnome.org/page.cgi?id=browse.html&product=vala +.SH "HOMEPAGE OR CONTACT" +https://wiki.gnome.org/Projects/Vala .SH FEATURES Interfaces, properties, signals, foreach, lambda expressions, type inference for local variables, generics, non-null types, assisted memory management, exception handling -.SH HOMEPAGE AND BUG REPORT -http://www.vala-project.org/ .SH AUTHORS -Jürg Billeter, Raffaele Sandrini. - -Man page written to conform with Debian by Marc-Andre Lureau. - +J??rg Billeter, Raffaele Sandrini. diff --git a/doc/valac.h2m b/doc/valac.h2m new file mode 100644 index 000000000..ce9bc23ba --- /dev/null +++ b/doc/valac.h2m @@ -0,0 +1,31 @@ +[NAME] +valac \- compiler that translates Vala source code into C source and header files + +[SYNOPSIS] +.B valac +[\fIOPTION\fR]... [\fIFILE\fR]... + +[DESCRIPTION] +Vala is a programming language that aims to bring modern +programming language features to GNOME developers without imposing any +additional runtime requirements and without using a different ABI +compared to applications and libraries written in C. +.TP +valac, the Vala compiler, is a self-hosting compiler that translates +Vala source code into C source and header files. It uses the GObject +type system to create classes and interfaces declared in the Vala +source code. + +[BUGS] +https://bugzilla.gnome.org/page.cgi?id=browse.html&product=vala + +[HOMEPAGE or CONTACT] +https://wiki.gnome.org/Projects/Vala + +[FEATURES] +Interfaces, properties, signals, foreach, lambda expressions, type +inference for local variables, generics, non-null types, assisted memory +management, exception handling + +[AUTHORS] +Jürg Billeter, Raffaele Sandrini. diff --git a/doc/vapigen.1 b/doc/vapigen.1 index 993bd4378..61bbf971c 100644 --- a/doc/vapigen.1 +++ b/doc/vapigen.1 @@ -1,5 +1,5 @@ -.TH vapigen 1 "13 April 2010" "vala-0.8.0" "Vala" -.IX vapigen +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.4. +.TH VAPIGEN "1" "March 2017" "vapigen API Generator 0.34.6" "User Commands" .SH NAME vapigen \- generate a Vala API .SH SYNOPSIS @@ -9,53 +9,52 @@ vapigen \- generate a Vala API .B vapigen is a utility which generates Vala API (VAPI) files from GI files, which may be generated using the vala-gen-introspect(1) utility. - -.SH EXAMPLES -.TP -After compilation, the following command generates a GI for pango: -.B vala-gen-introspect pango packages/pango +.SS "Usage:" +.IP +vapigen [OPTION?] FILE... \- Vala API Generator +.SS "Help Options:" .TP -This can then be converted to a Vala API as follows: -.B vapigen --pkg cairo --vapidir . --library pango packages/pango/pango.gi - -.SH OPTIONS +\fB\-h\fR, \fB\-\-help\fR +Show help options +.SS "Application Options:" .TP -.B \-?, --help -Show help option +\fB\-\-vapidir\fR=\fI\,DIRECTORY\/\fR... +Look for package bindings in DIRECTORY .TP -.B \--vapidir=\fIDIRECTORY\fP -Look for package bindings in \fIDIRECTORY\fP. +\fB\-\-girdir\fR=\fI\,DIRECTORY\/\fR... +Look for GIR bindings in DIRECTORY .TP -.B \--girdir=\fIDIRECTORY\fP -Look for GIR bindings in \fIDIRECTORY\fP. +\fB\-\-metadatadir\fR=\fI\,DIRECTORY\/\fR... +Look for GIR .metadata files in DIRECTORY .TP -.B \--metadatadir=\fIDIRECTORY\fP -Look for GIR .metadata files in \fIDIRECTORY\fP. +\fB\-\-pkg\fR=\fI\,PACKAGE\/\fR... +Include binding for PACKAGE .TP -.B \--pkg=\fIPACKAGE\fP -Include binding for \fIPACKAGE\fP +\fB\-\-library\fR=\fI\,NAME\/\fR +Library name .TP -.B \--library=\fINAME\fP -Specify library name as \fINAME\fP +\fB\-d\fR, \fB\-\-directory\fR=\fI\,DIRECTORY\/\fR +Output directory .TP -.B \-d, --directory=\fIDIRECTORY\fP -Specify output directory as \fIDIRECTORY\fP +\fB\-\-disable\-warnings\fR +Disable warnings .TP -.B \--version -Display version number and exit. +\fB\-\-version\fR +Display version number .TP -.B \-q, --quiet +\fB\-q\fR, \fB\-\-quiet\fR Do not print messages to the console - -.SH SEE ALSO -.BR vala-gen-introspect (1) - -.SH HOMEPAGE AND BUG REPORT -http://www.vala-project.org/ - -.SH AUTHOR -vapigen for Vala was written by Jürg Billeter <j@bitron.ch> and -Raffaele Sandrini <rasa@gmx.ch>. -.PP -This manual page was written by Kumar Appaiah <akumar@ee.iitm.ac.in>, -for the Debian project (but may be used by others). +.SH BUGS +https://bugzilla.gnome.org/page.cgi?id=browse.html&product=vala +.SH "HOMEPAGE OR CONTACT" +https://wiki.gnome.org/Projects/Vala +.SH AUTHORS +J??rg Billeter, Raffaele Sandrini. +.SH EXAMPLES +After compilation, the following command generates a GI for pango: +.B vala-gen-introspect pango packages/pango +.TP +This can then be converted to a Vala API as follows: +.B vapigen --pkg cairo --vapidir . --library pango packages/pango/pango.gi +.SH "SEE ALSO" +vala-gen-introspect (1) diff --git a/doc/vapigen.h2m b/doc/vapigen.h2m new file mode 100644 index 000000000..1f6ca8f23 --- /dev/null +++ b/doc/vapigen.h2m @@ -0,0 +1,30 @@ +[NAME] +vapigen \- generate a Vala API + +[SYNOPSIS] +.B vapigen \fISOURCE\fP \fIPKGBASE\fP +[\fIOPTION\fR]... [\fIFILE\fR]... + +[DESCRIPTION] +.B vapigen +is a utility which generates Vala API (VAPI) files from GI files, +which may be generated using the vala-gen-introspect(1) utility. + +[EXAMPLES] +After compilation, the following command generates a GI for pango: +.B vala-gen-introspect pango packages/pango +.TP +This can then be converted to a Vala API as follows: +.B vapigen --pkg cairo --vapidir . --library pango packages/pango/pango.gi + +[BUGS] +https://bugzilla.gnome.org/page.cgi?id=browse.html&product=vala + +[HOMEPAGE or CONTACT] +https://wiki.gnome.org/Projects/Vala + +[SEE ALSO] +vala-gen-introspect (1) + +[AUTHORS] +Jürg Billeter, Raffaele Sandrini. |