summaryrefslogtreecommitdiff
path: root/INSTALL.REPO
Commit message (Collapse)AuthorAgeFilesLines
* INSTALL.*: Advise use of 'install-doc' target.G. Branden Robinson2023-02-231-1/+1
| | | | Thanks to T. Kurt Bond for the suggestion.
* Scrub references to support for snapshot builds.G. Branden Robinson2022-08-031-44/+5
| | | | See previous reversion commit for rationale.
* Weaken build dependency on TeX.G. Branden Robinson2022-06-091-1/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | [build]: Weaken dependency on TeX, instead using it (to generate the DVI and PDF forms of our Texinfo manual) only if it is available. * m4/groff.m4 (GROFF_USE_TEX_CHECK): Check for presence of 'tex' executable in path. Set shell variable `groff_use_tex` to "yes" if present, and "no" otherwise. This check runs only if the 'makeinfo' and 'texi2dvi' version checks have already passed. * configure.ac: Run the new check. Set Automake conditional `USE_TEX` only if shell variable `groff_use_tex` is "yes". Report whether "groff.dvi" and "groff.pdf" are (re-)buildable. * doc/doc.am: Parameterize names of groff.{dvi,pdf} targets as Make macros `GROFF_DVI` and `GROFF_PDF`. Define them only if `USE_TEX`. Do _not_ update `EXTRA_DIST` macro; leave the literal file names there because we require that distribution archives contain these files. (.texi.dvi, .texi.pdf): Update suffix rules to check `USE_TEX` and fail, complaining of missing 'tex' program, if these targets are attempted without it being true. Only manually specifying the file names as targets to 'make' or attempting to generate a distribution archive without TeX present should cause these errors. * INSTALL.REPO: Update dependency information. Fixes <https://savannah.gnu.org/bugs/?62592>. Thanks to Deri James for the report.
* INSTALL.REPO: Add more snapshot archive material.G. Branden Robinson2022-06-031-0/+20
|
* INSTALL.REPO: Document more dependencies.G. Branden Robinson2022-06-021-0/+3
|
* FOR-RELEASE, HACKING, INSTALL.REPO, README: Tweak.G. Branden Robinson2022-05-261-2/+2
| | | | | | | | | | | | | | | | | | | * FOR-RELEASE: Split-off ChangeLog files need to be added to the distribution archive. * HACKING: Clarify non-ChangeLoggable items. Generally, an item that resolves a Savannah ticket should be ChangeLogged even if it would not normally meet that threshold. Also clarify a point in an example; we certainly expect table entries containing the word "FOOBAR" to show up that way when formatted. * INSTALL.REPO: Correct prose description of what to do with unpacked "gnulib" snapshot. * README: Clarify that the '.version' file is produced by the build process. Clarify origins and provenance of various groff components. Use a more appropriate URL for the Savannah issue tracker. Lightly recast.
* INSTALL.REPO: Revise.G. Branden Robinson2022-05-241-37/+87
| | | | | | | | | | | | | | | | | | | | | | | | | | * Expand introduction. * Eschew term "tarball" in favor of "archive". * The term "snapshot tarball" was undefined. If it meant the snapshot archives available for any groff commit via Savannah/cgit, then the existing wording wrongly implied that the "INSTALL.extra" instructions could be used for them. This is not true because gnulib is not included in those archives. If it meant something else, it's of limited use: all of our official archives for the past four years have been release candidates or final releases. Moreover, since we have had an automated test suite for roughly the same duration, our Git master branch is expected to be release-worthy at all times. * Consequently, define "snapshot archive" using the former definition. * Describe how to distinguish snapshot and distribution archives. * Un-enumerate section headings. * Cross-reference "INSTALL.extra" file for build dependencies shared between distribution archives and Git/snapshot builds. * Consistently prefix shell commands with a shell prompt '$'. * Add instructions for bootstrapping a snapshot archive, which requires obtaining a gnulib snapshot. * Move description of what bootstrapping does to its own section. * Add "Evaluation", "Installation", and "Uninstallation" sections. * Drop material on "automake.mom"; it is not applicable to building/installation per se, but rather to development.
* INSTALL.REPO, PROBLEMS: Migrate an item.G. Branden Robinson2022-05-221-15/+0
| | | | | | ...from the former file to the latter, recongizing it as essentially historical. Autoconf 2.68 has not been the latest release for over 10 years now.
* INSTALL.REPO, INSTALL.extra: Update.G. Branden Robinson2022-05-031-78/+46
| | | | | | | | | | | | | | | | | | | Bring discussion up to date. INSTALL.REPO: Bump documented autoconf dependency. Encourage use of '-j' option to make(1), but stop explaining it--multicore machines are standard these days and we can expect users building from Git to know this. Drop reassurance about transparent output-related diagnostics since we have kludgily disabled them for the time being. Drop discussion of 'doc' and 'install-doc' targets since they have been removed. Drop discussion of autoreconf(1) since groff's migration to Automake is a few years older now. Fix error: automake.pdf _is_ built by default; it's simply not installed. INSTALL.extra: Encourage use of '-j' option to make(1). Add discussion of "unprivileged installation". Simplify discussion of our Texinfo manual's output formats since they're all shipped with the distribution archive now.
* [docs]: Update installation instructions.G. Branden Robinson2021-10-161-5/+2
| | | | | | | | | | | | | * INSTALL.REPO: Update characterization of our test repertoire. * INSTALL.extra: Update documented compiler requirements; I don't think GCC 2.7.1 has been supported by anyone for many years. Document ISO C++98 requirement. Drop advice about use of alternative mallocs; I haven't seen any evidence of anyone doing this or suffering because they haven't. Add guidance re: uchardet '-dev{,el}' packages per suggestion from Deri James. Fix error: "latin1" is a groff device; "latin" is not. Also fix minor style nits (capitalization, quotation style).
* Update copyright1.23.0.rc1Bertrand Garrigues2020-11-111-1/+1
| | | | | | | | * update-copyright.sh: use gnulib's 'update-copyright' script. Pass this script in directories 'arch', 'contrib', 'font', 'man', 'tmac', 'src' and on a list of extra files. * FOR-RELEASE: mention this point.
* Revert "Update copyright"Bertrand Garrigues2020-10-251-1/+1
| | | | | | This reverts commit a2e955e07354c83939fabffebcf720d3333d1f6b. Some files (COPYING, FDL, bootstrap) should not have been updated
* Update copyrightBertrand Garrigues2020-10-251-1/+1
| | | | | | | | Use gnulib's update-copyright script. * src/roff/groff/groff.cpp: update the printf displayed when 'groff -v' is invoked. * FOR-RELEASE: mention this point.
* Reflow or fix long lines in top-level docs.G. Branden Robinson2020-04-291-3/+10
| | | | | | | This did not produce much churn except in README.MinGW, which seems to have been deliberately wrapped at 76 columns instead of 72--sorry. Also update (in INSTALL.REPO's case, add) editor settings.
* Install texinfo doc on 'make install-pdf' and 'make install-html'Bertrand Garrigues2018-12-131-0/+22
| | | | | | | | | | * doc/doc.am: - Use automake 'install-pdf-local' and 'install-html-local' rules to install groff.pdf and groff.html - New rules 'uninstall_pdf' and 'uninstall_html'. - Use $(RM) instead of 'rm'. - Don't try to build doc if 'BUILD_INFODOC' is not set. * INSTALL.REPO: document texinfo build and installation.
* Update copyright (use gnulib's update-copyright script)Bertrand Garrigues2018-07-031-1/+1
|
* Update installation doc.Bertrand Garrigues2018-02-261-0/+2
| | | | | | | | | | | | * INSTALL.REPO: mention that 'pkg-config' is a dependency. * INSTALL.extra: add dependency 'makeinfo' and optional dependencies 'pkg-config' and 'uchardet'. * TESTS: move to doc/automake_migration_tests.txt * INSTALL.gen: remove, this file is redundant with the 'INSTALL' file from gnulib.
* Add preconv(1) Coding Tags to mom example files and automake.mom.Peter Schaffter2018-02-171-0/+6
| | | | | | | | Add note to INSTALL.REPO to ignore "can't transparently output node at top level" and "can't translate character code n to special character 'c' in transparent throughput" warnings. Fix instructions for building typesetting.mom in mom/examples/README.txt to include -k flag.
* Fix build if `configure' check for `fprintf-posix' fails.Ingo Schwarze2017-08-151-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | See bug at: https://savannah.gnu.org/bugs/?51554. If tests for posix compliance of fprintf from `gnulib_m4/fprintf-posix.m4' fail, a replacement function of `fprintf' is used. Consequently, all executables that use this function must link against the gnulib (`libgnu.a'). The bug was introduced by commit fa41eeba06987a12bc0434f8b51896d4618a3997. * src/devices/xditview/xditview.am * src/preproc/eqn/eqn.am * src/preproc/pic/pic.am * src/preproc/preconv/preconv.am * src/preproc/refer/refer.am * src/preproc/soelim/soelim.am * src/preproc/tbl/tbl.am * src/utils/addftinfo/addftinfo.am * src/utils/hpftodit/hpftodit.am * src/utils/indxbib/indxbib.am * src/utils/lkbib/lkbib.am * src/utils/lookbib/lookbib.am * src/utils/pfbtops/pfbtops.am * src/utils/tfmtodit/tfmtodit.am * src/utils/xtotroff/xtotroff.am: link against libgnu.a * INSTALL.REPO: recommend the autoconf and automake versions used during automake migration rather than the minimum versions.
* Clean conflict lines left in INSTALL.REPOBertrand Garrigues2015-03-111-20/+0
|
* Added a short explanation in INSTALL.REPO on autotools versions, forBertrand Garrigues2015-01-271-0/+10
| | | | | | | | | systems that supports multiple autotools versions. Regexp in contrib/groffer/groffer.am: Basic regular expressions don't have a "+" bound. Both issues pointed out by Ingo Schwarze <schwarze@usta.de>.
* Fixes after final complete tests and documentation update.Bertrand Garrigues2015-01-271-23/+78
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Added a quick guide on the usage of automake in groff (doc/automake.mom, must be manually generated with pdfmom). * Makefile.am: distribute TESTS. and font/util/make-Rproto. * contrib/hdtbl/hdtbl.am: contrib/hdtbl/examples/fonts_n.in and fonts_x.in were not distributed. Examples (.ps files) of were mistakenly distributed. * contrib/mom/mom.am: Mom examples (pdf files) were mistakenly distributed. * contrib/pdfmark/pdfmark.am: pdfmark.pdf was mistakenly distributed. * doc/doc.am: unprotected '@' in sed command symbols caused missing substitution of @VERSION@ in some generated files. * font/devpdf/devpdf.am: font/devpdf/util/BuildFoundries (generated) was mistakenly distributed. * src/preproc/pic/pic.am: .n was mistakenly distributed, pic.man was not distributed. * tmac/tmac.am: some generated files were mistakenly distributed. * Updated INSTALL.REPO. * doc/automake.mom: new file.
* Fix `.gitignore' to really ignore `autom4te.cache' and friends.Werner Lemberg2014-09-051-8/+3
|
* groff top source dir: remove all "Last update" entries.Bernd Warken2014-09-031-2/+0
|
* In groff top source dir, change copyright years from start to actual yearBernd Warken2014-09-031-3/+2
|
* remove auto4te.cache manually; also mention this in .gitignoreBernd Warken2014-09-031-0/+5
|
* Remove Emacs coding setup in documentation files on top groff source. ↵Bernd Warken2014-09-031-1/+0
| | | | Repair some copyright years.
* In groff source top directory add Emacs settings for most text files.Bernd Warken2014-09-021-2/+8
|
* The groff-commit mailing list works with git, too.Werner Lemberg2013-12-231-4/+4
|
* Update top-level documentation regarding git repository and bug tracker.Werner Lemberg2013-12-221-31/+24
|
* Post-conversion cleanup.Eric S. Raymond2013-12-081-0/+71