Files
third_party_gettext/libtextstyle/HACKING
T
Bruno Haible 939ea33303 libtextstyle: New project.
* libtextstyle/AUTHORS: New file, extracted from gettext/AUTHORS.
* libtextstyle/COPYING: New file, copied from gettext/COPYING.
* libtextstyle/DEPENDENCIES: New file, based on gettext/DEPENDENCIES.
* libtextstyle/HACKING: New file, based on gettext/HACKING.
* libtextstyle/INSTALL: New file, copied from gettext/INSTALL.
* libtextstyle/Makefile.am: New file, based on libunistring/Makefile.am.
* libtextstyle/NEWS: New file.
* libtextstyle/README: New file, based on libunistring/README.
* libtextstyle/autogen.sh: New file, based on libunistring/autogen.sh.
* libtextstyle/configure.ac: New file, based on libunistring/configure.ac.
* libtextstyle/build-aux/texi2html: New file, copied from
libunistring/build-aux/texi2html.
* libtextstyle/doc/Makefile.am: New file, based on libunistring/doc/Makefile.am.
* libtextstyle/doc/fdl.texi: New file, copied from gnulib/doc/fdl.texi.
* libtextstyle/doc/gpl.texi: New file, copied from gnulib/doc/gpl-3.0.texi.
* libtextstyle/doc/libtextstyle.texi: New file, partially based on
gettext/gettext-tools/doc/gettext.texi.
* libtextstyle/examples/color-filter/INSTALL: New file, based on
gettext/gettext-tools/examples/hello-c/INSTALL.
* libtextstyle/examples/color-filter/Makefile.am: New file, based on
gettext/gettext-tools/examples/hello-c/Makefile.am.
* libtextstyle/examples/color-filter/README: New file.
* libtextstyle/examples/color-filter/autoclean.sh: New file, based on
gettext/gettext-tools/examples/hello-c/autoclean.sh.
* libtextstyle/examples/color-filter/autogen.sh: New file, based on
gettext/gettext-tools/examples/hello-c/autogen.sh.
* libtextstyle/examples/color-filter/configure.ac: New file.
* libtextstyle/examples/color-filter/filter.c: New file.
* libtextstyle/examples/color-filter/filter-default.css: New file.
* libtextstyle/examples/color-hello/INSTALL: New file, based on
gettext/gettext-tools/examples/hello-c/INSTALL.
* libtextstyle/examples/color-hello/Makefile.am: New file, based on
gettext/gettext-tools/examples/hello-c/Makefile.am.
* libtextstyle/examples/color-hello/README: New file.
* libtextstyle/examples/color-hello/autoclean.sh: New file, based on
gettext/gettext-tools/examples/hello-c/autoclean.sh.
* libtextstyle/examples/color-hello/autogen.sh: New file, based on
gettext/gettext-tools/examples/hello-c/autogen.sh.
* libtextstyle/examples/color-hello/configure.ac: New file.
* libtextstyle/examples/color-hello/hello.c: New file.
* libtextstyle/examples/color-hello/hello-default.css: New file.
* libtextstyle/examples/color-hello/names.c: New file.
* libtextstyle/lib/Makefile.am: New file, based on libunistring/lib/Makefile.am.
* libtextstyle/lib/misc.h: New file.
* libtextstyle/lib/misc.c: New file.
* libtextstyle/lib/notinline.h: New file, based on
libunistring/lib/unistring-notinline.h.
* libtextstyle/lib/stdbool.mini.h: New file, based on
libunistring/lib/stdbool.mini.h.
* libtextstyle/lib/textstyle.h: New file, based on
gnulib-local/lib/*ostream.oo.h.
* libtextstyle/lib/textstyle/version.in.h: New file, based on
libunistring/lib/unistring/version.in.h.
* libtextstyle/lib/textstyle/woe32dll.in.h: New file, based on
libunistring/lib/unistring/woe32dll.in.h.
* libtextstyle/lib/version.c: New file, based on libunistring/lib/version.c.
* libtextstyle/m4/init-package-version.m4: New file, copied from
libunistring/m4/init-package-version.m4.
* libtextstyle/tests/Makefile.am: New file, based on
libunistring/tests/Makefile.am.
* libtextstyle/version.sh: New file, based on libunistring/version.sh.
* libtextstyle/woe32dll/c++fd-styled-ostream.cc: New file.
* libtextstyle/woe32dll/c++html-styled-ostream.cc: New file.
* libtextstyle/woe32dll/c++term-styled-ostream.cc: New file.
* gnulib-local/lib/glib/gstring.c (g_string_append_c): In libtextstyle, honor a
macro definition.
* gnulib-local/lib/libxml/elfgcchack.h: In libtextstyle, make this entire file a
no-op.
* gnulib-local/lib/libxml/globals.in.h (docbDefaultSAXHandler,
htmlDefaultSAXHandler, oldXMLWDcompatibility, xmlBufferAllocScheme,
xmlDefaultBufferSize, xmlDefaultSAXHandler, xmlDefaultSAXLocator,
xmlDoValidityCheckingDefaultValue, xmlFree, xmlGenericError, xmlStructuredError,
xmlGenericErrorContext, xmlStructuredErrorContext, xmlGetWarningsDefaultValue,
xmlIndentTreeOutput, xmlTreeIndentString, xmlKeepBlanksDefaultValue,
xmlLineNumbersDefaultValue, xmlLoadExtDtdDefaultValue, xmlMalloc,
xmlMallocAtomic, xmlMemStrdup, xmlParserDebugEntities, xmlParserVersion,
xmlPedanticParserDefaultValue, xmlRealloc, xmlSaveNoEmptyTags,
xmlSubstituteEntitiesDefaultValue, xmlRegisterNodeDefaultValue,
xmlDeregisterNodeDefaultValue, xmlLastError,
xmlParserInputBufferCreateFilenameValue, xmlOutputBufferCreateFilenameValue): In
libtextstyle, honor a macro definition.
* gnulib-local/lib/libxml/globals.c (xmlFree, xmlMalloc, xmlMallocAtomic,
xmlMemStrdup, xmlRealloc, docbDefaultSAXHandler, htmlDefaultSAXHandler,
oldXMLWDcompatibility, xmlBufferAllocScheme, xmlDefaultBufferSize,
xmlDefaultSAXHandler, xmlDefaultSAXLocator, xmlDoValidityCheckingDefaultValue,
xmlGenericError, xmlStructuredError, xmlGenericErrorContext,
xmlStructuredErrorContext, xmlGetWarningsDefaultValue, xmlIndentTreeOutput,
xmlTreeIndentString, xmlKeepBlanksDefaultValue, xmlLineNumbersDefaultValue,
xmlLoadExtDtdDefaultValue, xmlParserDebugEntities, xmlParserVersion,
xmlPedanticParserDefaultValue, xmlSaveNoEmptyTags,
xmlSubstituteEntitiesDefaultValue, xmlRegisterNodeDefaultValue,
xmlDeregisterNodeDefaultValue, xmlLastError,
xmlParserInputBufferCreateFilenameValue, xmlOutputBufferCreateFilenameValue):
Likewise.
* gnulib-local/lib/libxml/xmlmemory.c (xmlMalloc): Likewise.
2019-02-10 20:59:08 +01:00

93 lines
2.4 KiB
Plaintext

All you need to know when hacking (modifying) GNU libtextstyle or when building
it off the git repository.
Requirements
============
You will need reasonably recent versions of the build tools:
* A C compiler; on Cygwin or mingw also a C++ compiler. Such as GNU GCC.
+ Homepage:
https://gcc.gnu.org/
* GNU automake 1.13 or newer
+ Homepage:
https://www.gnu.org/software/automake/
* GNU autoconf
+ Homepage:
https://www.gnu.org/software/autoconf/
* GNU m4
+ Homepage:
https://www.gnu.org/software/m4/
* GNU texinfo
+ Homepage:
https://www.gnu.org/software/texinfo/
* Perl
+ Homepage:
https://www.perl.org/
* TeX (for making the doc in .dvi, .ps or .pdf format)
+ Homepage:
https://tug.org/teTeX/
* Either an internet connection or a recent copy of GNU gnulib.
+ Homepage:
https://www.gnu.org/software/gnulib/
* GNU tar (for creating distributable tarballs)
+ Homepage:
https://www.gnu.org/software/tar/
* GNU Wget
+ Homepage:
https://www.gnu.org/software/wget/
And, of course, the packages listed in the DEPENDENCIES file.
Building off the git repository
===============================
Access to the git repository is described at
https://savannah.gnu.org/git/?group=gettext
After fetching the sources from the repository, go into the 'libtextstyle'
directory, peek at the comments in autogen.sh, then run "./autogen.sh";
then you can proceed with "./configure" as usual.
Submitting patches
==================
Patches should be sent to bug-gettext@gnu.org, the bug/feature mailing
list. You can subscribe to the mailing list, or see the list
archives, by following links from
https://savannah.gnu.org/mail/?group=gettext .
To email a patch you can use a shell command like 'git format-patch
-1' to create a file, and then attach the file to your email.
Changes you commit should contain the log entries in the commit message.
For the style of a ChangeLog entry, see the "Change Logs" section of
the GNU coding standards:
https://www.gnu.org/prep/standards/html_node/Change-Logs.html
Testing
=======
The unit tests don't cover much of the functionality.
To test the output on various terminal emulators, use the --color=test
option on the 'color-hello' or 'color-filter' program.
To test the signal handling, use the 'color-filter' program: run
yes | ./filter '.*'
and exercise the various signals.