aboutsummaryrefslogtreecommitdiff
path: root/share
Commit message (Collapse)AuthorAgeFilesLines
* Add an entity for portlint(1) which is needed by the ports-specificJohn Baldwin1999-09-291-1/+2
| | | | | | | section of the committers' guide. Notes: svn path=/head/; revision=5762
* Added entities forNik Clayton1999-09-261-1/+10
| | | | | | | | | | awk(1) date(1) gcc(1) grep(1) script(1) top(1) fastboot(8) ifconfig(8) sysctl(8) Needed for the "make world" section. Notes: svn path=/head/; revision=5733
* Added entity for gunzip. This is needed for the updated handbook entry inJim Mock1999-09-101-1/+2
| | | | | | | | | docs/13605 that I'll be committing shortly. Reviewed by: nik Notes: svn path=/head/; revision=5575
* Use install opiton -C for installing files.Wolfram Schneider1999-09-091-2/+2
| | | | Notes: svn path=/head/; revision=5574
* $Id$ -> $FreeBSD$Peter Wemm1999-09-068-8/+8
| | | | Notes: svn path=/head/; revision=5542
* Rudimentary support for <segmentedlist>. Just builds a table for theNik Clayton1999-09-031-0/+17
| | | | | | | entries, and works for HTML output only. Notes: svn path=/head/; revision=5505
* New entities for make(1), rlogin(1), scp(1), ssh(1), ssh-add(1),Nik Clayton1999-09-031-1/+9
| | | | | | | | ssh-agent(1), ssh-keygen(1), and telnet(1). Originally used in the soon-to-be-added SGML'd committer's guide. Notes: svn path=/head/; revision=5502
* Add a new FPI for the authors.ent file, so that it can be referencedNik Clayton1999-09-031-4/+16
| | | | | | | | | | by different documentation. Add 3 new FPIs for the French translations. They're not in the tree yet, but they will be soon. Notes: svn path=/head/; revision=5501
* New make(1) infrastructure. Split out docproj.docbook.mk into a numberNik Clayton1999-09-034-0/+739
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | of smaller doc.<foo>.mk files, reflecting the functionality they contain. Long overdue, kudos to the submitter for the carrying out the work. Also makes the files independent of the system include files that normally live in /usr/share/mk, making it easier for non-FreeBSD systems to download and build our docs (an important factor in making it easier to share our work with other projects). Finally, it (in theory) lets you build the docs with a r/o doc/ directory. Changes to the submitted files: doc.docbook.mk The HTML generation depends on ${DSLHTML}, and the print generation depends on ${DSLPRINT}. Changing these files will force a rebuild (which makes testing changes a little easier). Removed ${DOC}.doc target. It's a hangover from when I (mistakenly) thought that Jade could generate MS Word .doc files. Added support for using compress(1) to build .Z files (been on my todo list for ages). Fixed a couple of typos. Submitted by: Neil Blakey-Milner <nbm@mithrandr.moria.org> Notes: svn path=/head/; revision=5500
* Define new LANGCODE variable, which should contain the language nameNik Clayton1999-08-281-3/+24
| | | | | | | | | | | | | | | | | | | | | | and encoding for the documentation that's currently being built (e.g., 'en_US.ISO_8859-1', or 'es_ES.ISO_8859-1'). Used when building packages to create part of the package file name. Setting this involves an 'interesting' kludge -- suggestions for how better to achieve this within make(1) welcomed. package-*: No need to remove PLIST, it's always overwritten. Create empty COMMENT and DESCR files if they don't exist. Makes it easier to test this, without committing COMMENT and DESCR files all over the tree. Use the ${LANGCODE} variable in the package name. For example, the HTML pkg for the FAQ now looks like faq.en_US.ISO_8859-1.html.tgz, instead of just faq.html.tgz. Notes: svn path=/head/; revision=5464
* 1. Fix a subtle bug in the use of ${DOC}. If you ran make(1) and definedNik Clayton1999-08-261-25/+59
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | ${FORMATS} on the command line then it would assume that you wanted to build a document in the current directory, based on the setting of ${DOC}. If ${DOC} wasn't set, it defaulted to the name of the current directory. Any Makefile that includes this, and expects to have documentation built in the current directory must now explicitly define DOC. All the current ones do anyway. This should be a non-problem when docproj.docbook.mk is split out in to smaller, more modular files. Move the comments for DOC from the non-mandatory to the mandatory section. 2. Clarify the meaning of DESTDIR, it's changed a little bit since it was first documented. 3. Initial, tentative support for building pkg_* packages from the formatted documentation. Needs work, but I've had the patch out for review for a couple of days, and no comments either way -- so if people hate it, this should at least spur them on to say so. # cd /path/to/doc/to/turn/into/a/package # touch COMMENT DESCR # make 'FORMATS=this that and the other' package to build 'n' packages, one per format. "make install" is run as part of the package dependency, so this will overwrite documentation you have already got installed. 4. Remove DOC_INSTALL_PREFIX. Should have been DOCDIR from the start. Notes: svn path=/head/; revision=5451
* Remove the comment about <FAQList>, that's been obsoleted by DocBook 3.1.Nik Clayton1999-08-231-4/+33
| | | | | | | | | | | | | | Default to labelling questions with "Q:" and answers with "A:" when processing <qandaset>s. In the HTML output, render questions in a larger, bolder font than the answers. Requested by several people on -doc. Default to numbering sections. Requested by one person on -doc, who seemed somewhat confused that I hadn't read his mind and done this three months previously. cvs: ---------------------------------------------------------------------- Notes: svn path=/head/; revision=5430
* Use a conditional assignment "?=" when defining DOC_INSTALL_PREFIXNik Clayton1999-08-191-2/+2
| | | | Notes: svn path=/head/; revision=5395
* "-chown" was falling over when ${FORMAT} == html-split. Move the "-" toNik Clayton1999-08-181-3/+3
| | | | | | | the surrounding "for" loop. Notes: svn path=/head/; revision=5390
* The new Makefile framework. Does the right thing (pretty much) exceptNik Clayton1999-08-161-2/+2
| | | | | | | | | in the case of */FAQ/Makefile, because the FAQs are all in the wrong place. Things still install properly, but some of the directory paths are hardcoded. This will be going away ASAP. Notes: svn path=/head/; revision=5368
* Add DESTDIR and DOC_INSTALL_PREFIX variables.Nik Clayton1999-08-161-25/+35
| | | | | | | | | | | | | Pull in ../Makefile.inc if it exists. Don't use install(1), use cp(1), chmod(1), and chown(1). That way non-root users can install the files without install(1) complaining about the inability to change the owners. Nuke the "distribute" target. We don't need it where we're going. . . Notes: svn path=/head/; revision=5366
* Make ${INSTALL_COMPRESSED} and ${INSTALL_ONLY_COMPRESSED} truly optional.Nik Clayton1999-08-051-3/+3
| | | | | | | | PR: docs/12978 Submitted by: John Baldwin <jobaldwi@vt.edu> Notes: svn path=/head/; revision=5326
* D'oh. Add refs for loader.conf(5), boot(8), and loader(8), requiredNik Clayton1999-07-281-1/+4
| | | | | | | | | | by the recently committed "Serial Console" section. I had these in my local tree, and they slipped off my "list of things to commit" somehow. Prompted by: Kazutaka YOKOTA <yokota@zodiac.mech.utsunomiya-u.ac.jp> Notes: svn path=/head/; revision=5259
* Add entries for gzip(1), lndir(1), uname(1), execve(2), crypt(3),Nik Clayton1999-06-071-1/+7
| | | | | | | cvsupd(8). Notes: svn path=/head/; revision=5036
* Change ${DOCBOOKCATALOG} to point at the master catalog for all theNik Clayton1999-06-031-2/+2
| | | | | | | DocBook DTDs, not just the 3.0 one. Notes: svn path=/head/; revision=5014
* Switch to using DocBook 3.1. Pull out the FreeBSD specific FAQList*Nik Clayton1999-06-031-41/+4
| | | | | | | | elements, they are obsoleted by the DocBook QAndASet element (and sub-elements). Notes: svn path=/head/; revision=5013
* Change the FPI to show this is now a DocBook 3.1 based extension.Nik Clayton1999-06-031-2/+2
| | | | Notes: svn path=/head/; revision=5012
* Be smarter about setting DOC_PREFIX to /usr/doc. Only do it ifNik Clayton1999-05-181-3/+22
| | | | | | | | /usr/doc/share/mk/docproj.docbook.mk exists. Otherwise, warn the user they need to set it, and exit. Notes: svn path=/head/; revision=4914
* Show pkg_add(1) and pkg_create(1) instead pkg.add(1) and pkg.create(1)Jesus Rodriguez Cuesta1999-05-151-3/+4
| | | | | | | | | | Added entry for pkg_delete(1). Submmitted by: cjc@cc942873-a.ewndsr1.nj.home.com Right patch by: chris@calldei.com Notes: svn path=/head/; revision=4893
* Added a validate target to check that the SGML markup is valid withoutNik Clayton1999-05-051-8/+30
| | | | | | | | | | | | | | the overhead of running Jade. Added an ${EXTRA_CATALOGS} variable if your document needs to be processed with additional SGML catalogs (currently not used by anything, but might be some day). Switched the meaning of ${JADEFLAGS} and ${JADEOPTS} for consistency. All user-tweakable program options now match ${*FLAGS}. Notes: svn path=/head/; revision=4815
* Added many comments explaining what this file is and what it shouldNik Clayton1999-05-051-2/+36
| | | | | | | | | | contain. Define an FPI for ../../en/share/sgml/bookinfo.ent. Explain how to add other language specific FPIs. Notes: svn path=/head/; revision=4814
* Add an entity for ppp(8).Joseph Koshy1999-05-041-1/+2
| | | | Notes: svn path=/head/; revision=4799
* Add a definition for &man.lynx.1;Nik Clayton1999-04-291-1/+2
| | | | Notes: svn path=/head/; revision=4773
* Add ${TIDYFLAGS} to use -raw option for building Japanese handbook.Jun Kuriyama1999-04-201-3/+6
| | | | Notes: svn path=/head/; revision=4717
* Includable Makefile, contains most of the logic for converting DocBookNik Clayton1999-04-141-0/+354
| | | | | | | | | into a variety of different formats. Contains a lot of code that used to be in doc/en/handbook/Makefile, the commit log for that file will probably prove useful as well. Notes: svn path=/head/; revision=4688
* Add some more references to manual pages. Not yet used by Handbook,Nik Clayton1999-04-121-1/+8
| | | | | | | but soon to be committed docs use them. Notes: svn path=/head/; revision=4679
* Add temporary option %lang.ja.dsssl;.Jun Kuriyama1999-04-081-1/+4
| | | | | | | | | Current version of dsssl-docbook-modular has Japanese option, but this doesn't satisfy our needs. Until I write a patch, Japanese stylesheet should be off. Notes: svn path=/head/; revision=4636
* Hmm. I already committed this remotely, it doesn't seem to have 'stuck'.Nik Clayton1999-04-051-0/+1
| | | | | | | | | | Explicitly set %lang.ja to "IGNORE", it will need to be turned on with something like jade -ilang.ja ... Notes: svn path=/head/; revision=4615
* Remove old hack to indent verbatim environments, and use new, Norm WalshNik Clayton1999-04-041-28/+11
| | | | | | | | | | | | | | sanctioned hack to indent verbatim environments :-) Explicitly turn off formatting a <variablelist> as a table, it's still buggy. Rename "usen-*" to "en-*", as the usage changed in the underlying stylesheets. The leader to a <warning> or <caution> should now have the ":" in the correct position. Notes: svn path=/head/; revision=4604
* Add Japanese specific definitions.Jun Kuriyama1999-04-041-0/+5
| | | | Notes: svn path=/head/; revision=4602
* Created a new set of entities for manual pages.Nik Clayton1999-03-072-3/+118
| | | | | | | | | | | | | | | | | | | | | | | | | | | The construct: <citerefentry> <refentrytitle>foobar</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> is a pain to type, and messes up the pretty-printing of the source code. Replace every occurence of a entry like that with: &man.foobar.1; Adjusting the manual page name and section number appropriately. The definitions for these entities are stored in man-refs.ent. This file is in doc/share/sgml because it is not just specific to the Handbook. I expect the DocBook'd FAQ and Tutorials (coming RSN) to use them as well. A new PUBLIC identifier has been created for these entities, and added to the catalog file. Notes: svn path=/head/; revision=4471
* Removed the reference to handbook.css, that shouldn't be in there yet.Nik Clayton1999-01-271-4/+1
| | | | | | | | Turned html-manifest from #t to #f. This can be set to #t via an option to jade(1), but the reverse is not true. Notes: svn path=/head/; revision=4136
* Move doc/sgml/* to doc/share/sgml/*, so it better follows the layout ofNik Clayton1999-01-253-0/+286
Doc. Proj. related ports under $PREFIX/share. Update en/handbook/Makefile with the new paths. Didn't seem worthwhile to do a repository copy for only three files moved. Notes: svn path=/head/; revision=4110