summaryrefslogtreecommitdiffstats
path: root/doc/Makefile
Commit message (Collapse)AuthorAgeFilesLines
* Remove the last vestiges of the texinfo docsBen Kaduk2012-10-151-56/+0
| | | | | | | | | | | | | | We needed these last stragglers to build the NOTICE file at the root of the tree, but we now generate a notice.txt from reST. Man pages have been generated from reST for some time now, we no longer need scripts to turn them into HTML and ps, as those can be generated directly from the reST source. The Makefile only existed to serve the texinfo builds, so it goes away, too. (The tgz target appears to have been broken since 1996.) ticket: 7408
* Remove texinfo implementors guideBen Kaduk2012-10-151-9/+0
| | | | | | | | | It is sufficiently old and unloved that nothing in it should be taken as truth without independent verification. Content of this nature should live on k5wiki.kerberos.org in the future. ticket: 7408
* Remove make glue for texinfo users guideBen Kaduk2012-10-151-35/+1
| | | | | | Towards removing the texinfo docs entirely. ticket: 7408
* Disconnect the texinfo users guide from the buildBen Kaduk2012-10-151-1/+1
| | | | | | | | | | | | | | | | | | Its content has been migrated to or superseded by the krb_users reST documentation. The texinfo document attempted to have a general introduction to Kerberos, but it is not quite suitable for the target audience of the user's guide and will be rewritten. A few portions of the texinfo document are simply no longer relevant and do not need to be migrated. In particular: The krb5-appl utilities are out of scope for this document, as they have been moved to a separate repository. Coverage of ksu may be brought back at a later time, though. The Kerberos Glossary will be expanded and handled separately. ticket: 7408
* Remove make glue for texinfo admin guideBen Kaduk2012-10-121-30/+1
| | | | | | Towards removing the texinfo docs entirely. ticket: 7408
* Disconnect the texinfo admin guide from the buildBen Kaduk2012-10-121-1/+1
| | | | | | | | | | | | | | | | | Its content has been migrated to or superseded by the reST documentation, essentially entirely in krb_admins. A few portions of the texinfo document are simply no longer relevant and do not need to be migrated. In particular: Information about reporting bugs lives on k5wiki.kerberos.org. General Kerberos concepts/introduction will be elsewhere in the tree. We do not need to document the time zones accepted by kadmin. We do not need a table of the various error codes and strings in our formal documentation. A complete description of the layout of our source tree is not useful or relevant to most Kerberos administrators. ticket: 7408
* Remove unused texinfo sourcesBen Kaduk2012-10-101-1/+1
| | | | | | | | Now that the install guide make rules are removed, nothing references build.texinfo or install.texinfo any more (other than the tgz target, which is updated accordingly). ticket: 7408
* Remove make glue for texinfo install guideBen Kaduk2012-10-101-30/+1
| | | | | | Towards removing the texinfo docs entirely. ticket: 7408
* Disconnect texinfo install guide from the buildBen Kaduk2012-10-101-1/+1
| | | | | | | | | | | | | | | | | Its content has been migrated to or superseded by the RST documentation, split amongst krb_build and various sections of krb_admins. A few portions of the texinfo document are simply no longer relevant and do not need to be migrated. In particular: It's 2012; we don't need to specify that we require a C89 compiler. It's 2012; it will be easy to get enough disk to build krb5. The KADM5 tests are part of 'make check' and don't need separate documentation. Shared library support is not limited to "a few operating systems". We do not need to document incompatibilities with ancient/dead OSes. kadmind4 and v5passwdd are no longer relevant. ticket: 7408
* Remove bug-report.texinfoBen Kaduk2012-10-081-1/+1
| | | | | | It is unused; send-pr.texinfo supercedes it at the moment anyway. ticket: 7408
* Move rstman build target to man directoryGreg Hudson2012-03-281-15/+0
| | | | | | | rstman makes more sense in man than in doc, so move it there. Remove the rstman target from the top-level doc Makefile to avoid confusion. git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@25792 dc483132-0cff-0310-8789-dd5450dbe970
* Add shadow manpages for k5login.5 and k5identity.5Tom Yu2012-01-131-3/+4
| | | | | | | | | | | | Add shadow manpages dot.k5login and dot.k5identity for k5login.5 and k5identity.5. Stop generating .k5login.5 and .k5identity.5 from sphinx (these will be taken care of by make install in src/man). Add generated k5identity.5. Add SYNOPSIS sections to k5login.5 and k5identity.5 to make it more clear that the filenames start with a dot. git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@25653 dc483132-0cff-0310-8789-dd5450dbe970
* install sphinx-generated manpagesTom Yu2012-01-091-0/+14
| | | | | | | | | | | | | | | | | Install sphinx-generated manpages. Original nroff manpages remain for reference until proofreading is complete. Modify doc/rst_source/conf.py to better deal with shadow manpages -- sphinx will now build k5login.5 instead of .k5login.5, and kadmin.1 instead of both kadmin.1 and kadmin.local.8. Proofreaders should ensure that the original nroff manpages (and associated Makefile rules) are deleted once their reST format equivalents have been proofread. ticket: 7064 status: open git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@25625 dc483132-0cff-0310-8789-dd5450dbe970
* Start building PDF docs by defaultTom Yu2011-06-101-3/+3
| | | | git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@24965 dc483132-0cff-0310-8789-dd5450dbe970
* modernize doc/Makefile somewhatTom Yu2011-05-021-2/+3
| | | | | | | | | | Modernize doc/Makefile somewhat so that it can run more usefully on modern non-Athena machines. ticket: 6906 status: open git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@24909 dc483132-0cff-0310-8789-dd5450dbe970
* copyright notice updatesTom Yu2010-10-141-0/+3
| | | | | | | | | | | | Update copyright.texinfo. Move full copyright notices to appendices of documentation. New rules to generate top-level NOTICE file from copyright.texinfo. Regenerate NOTICE file. ticket: 6802 tags: pullup target_version: 1.9 git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@24455 dc483132-0cff-0310-8789-dd5450dbe970
* Remove appl man pages from the list of pages to convert in the docGreg Hudson2009-11-241-6/+1
| | | | | | build system. git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@23341 dc483132-0cff-0310-8789-dd5450dbe970
* In doc/Makefile, specify the new location of the kpasswd man page (theGreg Hudson2009-08-141-2/+2
| | | | | | | | old one was removed in r22521. ticket: 6544 git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@22522 dc483132-0cff-0310-8789-dd5450dbe970
* Remove documentation references to krb4 functionality we no longerGreg Hudson2008-12-181-26/+1
| | | | | | | | | have. Remove the krb425 transition guide since we no longer have compatibility code to assist with a transition. ticket: 6303 git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@21545 dc483132-0cff-0310-8789-dd5450dbe970
* Add PKINIT supportKevin Coffman2007-08-011-1/+1
| | | | | | | | | | | | | | | | Pull up PKINIT support onto the trunk. Changes from the version in branch users/coffman/pkinit are: - Update the preauth plugin interface version to avoid conflict with any existing plugins. - Add a pkcs11.h locally to the pkinit code rather than depending on opensc being installed. ticket: new Target_Version: 1.6.3 git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@19745 dc483132-0cff-0310-8789-dd5450dbe970
* don't split HTML output from makeinfoTom Yu2006-12-211-1/+1
| | | | | | | | | | | * doc/Makefile (HTML): To avoid generating excessively long filenames, don't split HTML output. ticket: new target_version: 1.6 tags: pullup git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@19002 dc483132-0cff-0310-8789-dd5450dbe970
* * Makefile (clean-tex): Delete *.fns, *.vrs, *.tps too.Ken Raeburn2005-04-211-1/+10
| | | | | | (implementor.pdf, implementor.ps, implementor.info): New targets. git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@17191 dc483132-0cff-0310-8789-dd5450dbe970
* build user-guide.pdf tooKen Raeburn2005-03-041-0/+3
| | | | git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@17113 dc483132-0cff-0310-8789-dd5450dbe970
* Build/delete PDF filesKen Raeburn2005-03-041-1/+8
| | | | | | | | * Makefile (PSPDF): New variable. (admin-guide.pdf, install-guide.pdf): New targets. (clean-final): Delete PDF files. git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@17112 dc483132-0cff-0310-8789-dd5450dbe970
* * Makefile: made the list of manpages a variableJen Selby2002-09-201-1/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * admin.texinfo: took out second inclusion of copyright notice, changed some section names, updated initial synopsis of file, added explanation of encryption types and the [login] section of krb5.conf, added documentation on various tags in the configuration files, added some more examples, fixed some typos, updated usage statements for various kadmin and kdb5_util commands, updated the sample output from the commands, updated the infotex for use with makeinfo --html, added a section about getting shared-realm keys, updated the error codes * build.texinfo: added a section describing the structure of the source code tree, updated documentation of options to configure script, added information about defaults for various variable settings, updated information about shared library support, added discussion of valid kerberos principals * definitions.texinfo: added some new default variables, corrected some pathnames of default values * dnssrv.texinfo: made the information about default port numbers reference a variable * glossary.texinfo: updated definition of principal * install.texinfo: fixed typos and formatting errors, removed old sample config files from appendix (samples are in the sections about the config files), added information about supporting RC4 keys * kadm5.acl: new file. describes the kadm5.acl file. included by both admin.texinfo and install.texinfo. text is made up mostly of text that was split between those two documents. documentation of backreferences was added * kdcconf.texinfo: made defaults reference variables * krb425.texinfo: deleted second inclusion of copyright info, made defaults reference variable, fixed typos, took out redundant part about editing inetd.conf and replaced it with reference to install guide * krb5conf.texinfo: documented the "final variable" feature, added mention of the [login] section, * send-pr.texinfo: minor change in wording for clarity * user-guide.texinfo: made various minor wording changes, updated some of the sample output, updated documention of command options git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@14891 dc483132-0cff-0310-8789-dd5450dbe970
* * Makefile: changed the way html output is generated, made "make all"Jen Selby2002-06-261-4/+18
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | remove generated tex files * admin.texinfo: added sections about encryption types and salts, updated the configuration file sections, revised the example configuration files, updated dates on output strings, added an explanation of destroying a Kerberos database * build.texinfo: changed the description of the tarball * definitions.texinfo: added variables for all the default values so that they can all be updated in one place, changed the release from 1.2 to 1.3 * dnstxt.texinfo updated the information * install.texinfo added more description of the configuration files and the minimum needed in the files to set up a kerberos realm, revised the examples of the configuration file sections, took out old encryption type and salt information * kdcconf.texinfo: new file, taken from the admin guide and included in both the admin and install guides, provides descriptions of the sections in kdc.conf * krb425.texinfo: moved a texinfo tag so that makeinfo --html would work * krb5conf.texinfo: new file, take from the admin guide and included in both the admin and install guides, provides descriptions of the sections in krb5.conf * man2html, man2html.M: new files, a perl program to create html pages from the output of the man command * salts.texinfo: new file, a description of the different salt types that are currently supported * support-enc.texinfo: new file, a description of the currently supported encryptions types * user-guide.texinfo: added a section describing different ticket flags, added a way to have the man pages in the reference section accessible in the html version of the documentation git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@14587 dc483132-0cff-0310-8789-dd5450dbe970
* merge from V1_0_RELEASETom Yu1996-12-241-4/+4
| | | | git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@9686 dc483132-0cff-0310-8789-dd5450dbe970
* Brought reasonable krb425.texinfo over from Cygnus. Added section toJeff Bigler1996-11-151-6/+31
| | | | | | Makefile to make v4-to-v5 guide. git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@9424 dc483132-0cff-0310-8789-dd5450dbe970
* * Makefile: Apply jik's changes for dependencies [krb5-doc/101]Tom Yu1996-11-021-10/+60
| | | | git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@9276 dc483132-0cff-0310-8789-dd5450dbe970
* admin.texinfo, install.texinfo: Set edition to "b7-1"Theodore Tso1996-09-071-2/+7
| | | | | | | | | | | | | | | | | | | | | | user-guide.texinfo: Set edition to "b7-1". Fix the hoffset and voffsets for the included man page poscript files so that the images are lined up correctly (at least using MIT's dvips). Makefile (user-guide): Make sure the kpasswd man page's postscript is built. Add new target "clean-temp-ps" which cleans up the temporary postscript files. man2ps: Changes to make man2ps more portable. Remove bash specific constructs, and replace with calls to expr. Since the arguments to "troff" require groff, just try to run groff explicitly (someone can always edit the ROFF and ROFF_OPTIONS at the top of the script). Try to automatically detect whether csplit or gcsplit should be used, by grovelling through the user's path. texinfo.tex: Check in version of texinfo.tex that has Jeff's magic doubleleft arrow hack. git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@9055 dc483132-0cff-0310-8789-dd5450dbe970
* Renamed cyg-install.texinfo to install.texinfo.Jeff Bigler1996-09-061-4/+4
| | | | | | | | Renamed install.texi to install-old.texi. Added include file bug-report.texinfo Made relevant changes in Makefile. git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@9047 dc483132-0cff-0310-8789-dd5450dbe970
* make all should now DTRTJeff Bigler1996-09-061-2/+1
| | | | git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@9046 dc483132-0cff-0310-8789-dd5450dbe970
* Edited so makeinfo works properly. (We can't use @ifset MIT and @ifsetJeff Bigler1996-09-061-1/+2
| | | | | | | CYGNUS with makeinfo. *sigh*) Also replaced all of build.texinfo with section from install.texi. git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@9045 dc483132-0cff-0310-8789-dd5450dbe970
* Completely rewrote Makefile. Fixed up man2ps script and wrote manpageJeff Bigler1996-09-061-9/+62
| | | | | | for it. git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@9040 dc483132-0cff-0310-8789-dd5450dbe970
* * Makefile (clean): Remove *.info-? nowEzra Peisach1996-03-201-1/+1
| | | | | | | * install.texi: Changes to allow emacs M-X texinfo-format-buffer to work. (The problem was @item used within @enumerate). git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@7684 dc483132-0cff-0310-8789-dd5450dbe970
* Simple Makefile to build the dvi and info forms of the manual. CleanEzra Peisach1995-10-171-0/+15
rules work as well. git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@6973 dc483132-0cff-0310-8789-dd5450dbe970