Relevant BUGIDs:

Purpose of commit: cleanup

Commit summary:
---------------

        * doc/CREDITS: Removed.
        * doc/NOTES: Removed.
        * doc/pam_appl.sgml: Removed.
        * doc/pam_modules.sgml: Removed.
        * doc/pam_source.sgml: Removed.
        * doc/figs/pam_orient.txt: Removed.
        * doc/figs: Removed.

        * configure.in: Remove checks for sgml2* progrs, add sag, adg
        and mwg Makefiles.

        * doc/Makefile.am: Remove references to sgml, add sag, adg and mwg
        directories.
This commit is contained in:
Thorsten Kukuk 2006-06-28 14:41:18 +00:00
parent 504eedccf7
commit 95e6b22ccd
10 changed files with 26 additions and 4660 deletions

View File

@ -15,6 +15,20 @@
* doc/mwg/Linux-PAM_MWG.xml: New, main XML document.
* doc/mwg/pam_*.xml: New, wrappers to include manual pages.
* doc/CREDITS: Removed.
* doc/NOTES: Removed.
* doc/pam_appl.sgml: Removed.
* doc/pam_modules.sgml: Removed.
* doc/pam_source.sgml: Removed.
* doc/figs/pam_orient.txt: Removed.
* doc/figs: Removed.
* configure.in: Remove checks for sgml2* progrs, add sag, adg
and mwg Makefiles.
* doc/Makefile.am: Remove references to sgml, add sag, adg and mwg
directories.
2006-06-28 Thorsten Kukuk <kukuk@thkukuk.de>
* release version 0.99.5.0

3
NEWS
View File

@ -1,6 +1,9 @@
Linux-PAM NEWS -- history of user-visible changes.
* Documentation: Convert sgml guides to XML, unify documentation
for PAM functions and modules.
Release 0.99.5.0
* pam_tally: Fix support for large UIDs

View File

@ -402,29 +402,6 @@ AC_CHECK_FUNCS(inet_ntop inet_pton ruserok_af)
AC_CHECK_FUNCS(unshare, [UNSHARE=yes], [UNSHARE=no])
AM_CONDITIONAL([HAVE_UNSHARE], [test "$UNSHARE" = yes])
dnl Checks for programs/utilities
AC_CHECK_PROG(SGML2PS, sgml2ps, yes, no)
AC_CHECK_PROG(SGML2TXT, sgml2txt, yes, no)
AC_CHECK_PROG(SGML2HTML, sgml2html, yes, no)
AC_CHECK_PROG(SGML2LATEX, sgml2latex, yes, no)
AC_CHECK_PROG(PS2PDF, ps2pdf, yes, no)
AM_CONDITIONAL([HAVE_SGML2PS], [test "$SGML2PS" = yes || test "$SGML2LATEX" = yes])
AM_CONDITIONAL([HAVE_SGML2TXT], [test "$SGML2TXT" = yes])
AM_CONDITIONAL([HAVE_SGML2HTML], [test "$SGML2HTML" = yes])
AM_CONDITIONAL([HAVE_PS2PDF], [test "$PS2PDF" = yes])
if test $SGML2LATEX = "yes" ; then
if sgml2latex -h | grep -e --paper | grep ' -p ' > /dev/null ; then
PSER="sgml2latex -o ps"
else
PSER="sgml2latex -p"
fi
else
if test $SGML2PS = yes ; then
PSER="sgml2ps"
fi
fi
AC_SUBST(PSER)
dnl
dnl Check for xsltproc
dnl
@ -447,7 +424,10 @@ else
enable_man=no
fi
AC_PATH_PROG([FO2PDF], [fop])
AM_CONDITIONAL(ENABLE_REGENERATE_MAN, test x$enable_man != xno)
AM_CONDITIONAL(ENABLE_GENERATE_PDF, test ! -z "$FO2PDF")
AM_GNU_GETTEXT_VERSION
@ -513,4 +493,5 @@ AC_OUTPUT(Makefile libpam/Makefile libpamc/Makefile libpamc/test/Makefile \
modules/pam_unix/Makefile modules/pam_userdb/Makefile \
modules/pam_warn/Makefile modules/pam_wheel/Makefile \
modules/pam_xauth/Makefile doc/Makefile doc/specs/Makefile \
doc/man/Makefile examples/Makefile tests/Makefile)
doc/man/Makefile doc/sag/Makefile doc/adg/Makefile \
doc/mwg/Makefile examples/Makefile tests/Makefile)

View File

@ -1,49 +0,0 @@
<!--
an sgml list of people to credit for their contributions to Linux-PAM
$Id$
-->
Chris Adams,
Peter Allgeyer,
Tim Baverstock,
Tim Berger,
Craig S. Bell,
Derrick J. Brashear,
Ben Buxton,
Seth Chaiklin,
Oliver Crow,
Chris Dent,
Marc Ewing,
Cristian Gafton,
Emmanuel Galanos,
Brad M. Garcia,
Eric Hester,
Michel D'Hooge,
Roger Hu,
Eric Jacksch,
Michael K. Johnson,
David Kinchlea,
Olaf Kirch,
Marcin Korzonek,
Stephen Langasek,
Nicolai Langfeldt,
Elliot Lee,
Luke Kenneth Casson Leighton,
Al Longyear,
Ingo Luetkebohle,
Marek Michalkiewicz,
Robert Milkowski,
Aleph One,
Martin Pool,
Sean Reifschneider,
Jan Rekorajski,
Erik Troan,
Theodore Ts'o,
Jeff Uphoff,
Myles Uyema,
Savochkin Andrey Vladimirovich,
Ronald Wahl,
David Wood,
John Wilmes,
Joseph S. D. Yao
and
Alex O. Yuriev.

View File

@ -2,143 +2,33 @@
# Copyright (c) 2005, 2006 Thorsten Kukuk <kukuk@suse.de>
#
SUBDIRS = man specs
SUBDIRS = man specs sag adg mwg
FILES=pam pam_appl pam_modules
FSRCS=$(srcdir)/pam_appl.sgml $(srcdir)/pam_modules.sgml
CLEANFILES = *~
TEXTS=txts/pam.txt txts/pam_appl.txt txts/pam_modules.txt
HTMLS=html/pam.html html/pam_appl.html html/pam_modules.html
PSFILES=ps/pam.ps ps/pam_appl.ps ps/pam_modules.ps
PDFFILES=pdf/pam.pdf pdf/pam_appl.pdf pdf/pam_modules.pdf
MODULES=$(shell ls $(srcdir)/modules/*.sgml)
CLEANFILES = *~ */*~ $(TEXTS) $(PSFILES) $(PDFFILES) html/pam*.html \
ps/missfont.log MODULES-SGML pam.sgml
EXTRA_DIST = $(FSRCS) CREDITS NOTES figs/pam_orient.txt pdf/README \
ps/README html/index.html txts/README \
pam_source.sgml $(MODULES) modules/module.sgml-template \
modules/README
EXTRA_DIST = pdf/README html/index.html txts/README
#######################################################
all: html text postscript pdf
html: $(HTMLS)
$(HTMLS) : $(FSRCS) $(srcdir)/pam.sgml
@echo 'Building html documentation from files in modules/*.sgml'
if HAVE_SGML2HTML
@for i in $(FILES) ; do \
if [ ! -f "html/$$i.html" ] || [ "$(srcdir)/$$i.sgml" -nt "html/$$i.html" ]; \
then \
mkdir -p html ; \
cd html ; sgml2html ../$(srcdir)/$$i ; \
if [ $$? -ne 0 ]; then exit 1 ; fi ; \
cd .. ; \
fi ; \
done
else
@echo XXX - you do not have the sgml2html binary installed
endif
text: $(TEXTS)
$(TEXTS) : $(FSRCS) $(srcdir)/pam.sgml
@echo 'Building text documentation from files in modules/*.sgml'
if HAVE_SGML2TXT
@for i in $(FILES) ; do \
if [ ! -f "txts/$$i.txt" ] \
|| [ "$(srcdir)/$$i.sgml" -nt "txts/$$i.txt" ]; then \
mkdir -p txts ; \
cd txts ; sgml2txt ../$(srcdir)/$$i ; cd .. ; \
fi ; \
done
else
@echo XXX - you do not have the sgml2txt binary installed
endif
postscript: $(PSFILES)
$(PSFILES): $(FSRCS) $(srcdir)/pam.sgml
@echo 'Building postscript documentation from files in modules/*.sgml'
if HAVE_SGML2PS
@for i in $(FILES) ; do \
if [ ! -f "ps/$$i.ps" ] || [ "$(srcdir)/$$i.sgml" -nt "ps/$$i.ps" ]; then \
mkdir -p ps ; \
cd ps ; $(PSER) ../$(srcdir)/$$i ; cd .. ; \
fi ; \
done
else
@echo XXX - neither sgml2ps nor sgml2latex binaries are installed
endif
pdf: $(PDFFILES)
$(PDFFILES) : $(PSFILES)
@echo 'Building PDF documentation from files in modules/*.sgml'
if HAVE_SGML2PS
if HAVE_PS2PDF
@for i in $(FILES) ; do \
if [ ! -f "pdf/$$i.pdf" ] || [ "ps/$$i.ps" -nt "ps/$$i.pdf" ]; then \
mkdir -p pdf ; \
ps2pdf ps/$$i.ps pdf/$$i.pdf ; \
fi ; \
done
else
@echo XXX - ps2pdf is not installed
endif
else
@echo XXX - neither sgml2ps nor sgml2latex binaries are installed
endif
$(srcdir)/pam.sgml: $(srcdir)/pam_source.sgml MODULES-SGML CREDITS
@sed -e '/^<!\-\- insert\-file MODULES\-SGML \-\->/r MODULES-SGML' $(srcdir)/pam_source.sgml |\
sed -e '/^<!\-\- insert\-file CREDITS \-\->/r CREDITS' > $(srcdir)/pam.sgml
MODULES-SGML: $(MODULES)
@echo 'Building module text from files in modules/*.sgml'
@rm -f MODULES-SGML
@echo '<!-- modules included:' > MODULES-SGML
@ls $(srcdir)/modules/*.sgml >> MODULES-SGML
@echo ' and that is all -->' >> MODULES-SGML
@cat $(srcdir)/modules/*.sgml >> MODULES-SGML
extraclean: clean
install-data-local:
$(mkinstalldirs) $(DESTDIR)$(DOCDIR)
if HAVE_SGML2TXT
$(mkinstalldirs) $(DESTDIR)$(DOCDIR)/text
for file in txts/*.txt; do \
$(INSTALL_DATA) $$file $(DESTDIR)$(DOCDIR)/text; \
done
endif
if HAVE_SGML2PS
$(mkinstalldirs) $(DESTDIR)$(DOCDIR)/ps
for file in ps/*.ps; do \
$(INSTALL_DATA) $$file $(DESTDIR)$(DOCDIR)/ps; \
done
if HAVE_PS2PDF
$(mkinstalldirs) $(DESTDIR)$(DOCDIR)/pdf
for file in pdf/*.pdf; do \
$(INSTALL_DATA) $$file $(DESTDIR)$(DOCDIR)/pdf; \
done
endif
endif
if HAVE_SGML2HTML
$(mkinstalldirs) $(DESTDIR)$(DOCDIR)/html
for file in html/*.html; do \
$(INSTALL_DATA) $$file $(DESTDIR)$(DOCDIR)/html; \
done
endif
releasedocs: all
tar zvfc ../Linux-PAM-$(VERSION)-docs.tar.gz \
--exclude CVS --exclude .cvsignore --exclude '.#*' \
--exclude README html ps txts pdf \
--exclude README html txts pdf \
specs/draft-morgan-pam-current.txt specs/rfc86.0.txt
tar jvfc ../Linux-PAM-$(VERSION)-docs.tar.bz2 \
--exclude CVS --exclude .cvsignore --exclude '.#*' \

View File

@ -1,16 +0,0 @@
Things to be added:
@ modules:
@ application:
use of
'user' = user to become,
'uid' = user requesting service
'euid' = privilege of current process.
@ sysadmin:
included modules:
behavior
non-included modules:
behavior/pointers.

View File

@ -1,23 +0,0 @@
+----------------+
| application: X |
+----------------+ / +----------+ +================+
| authentication-[---->--\--] Linux- |--<--| /etc/pam.conf |
| + [----<--/--] PAM | |================|
|[conversation()][--+ \ | | | X auth .. a.so |
+----------------+ | / +-n--n-----+ | X auth .. b.so |
| | | __| | | _____/
| service user | A | | |____,-----'
| | | V A
+----------------+ +------|-----|---------+ -----+------+
+---u-----u----+ | | |
| auth.... |--[ a ]--[ b ]--[ c ]
+--------------+
| acct.... |--[ b ]--[ d ]
+--------------+
| password |--[ b ]--[ c ]
+--------------+
| session |--[ e ]--[ c ]
+--------------+

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff