sin/samba-mirror
1
0
Fork 0
mirror of https://github.com/samba-team/samba.git synced 2025-01-10 01:18:15 +03:00
Code

- Be a bit more verbose.

Browse Source 
- Try some more possibilities when looking for 3.0 sources.
- Fix "make files"
(This used to be commit 0e33ad6b3b)
This commit is contained in:
Jelmer Vernooij 2005-03-11 15:57:45 +00:00 committed by Gerald W. Carter
parent 2f5e431faf
commit fedcbe8f08
6 changed files with 18 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
docs/Makefile
View File

@ -1,5 +1,5 @@
#################################################################
# Makefile.in for Samba Documentation
# Makefile for Samba Documentation
# Authors:
# James Moore <jmoore@php.net>
# Gerald Carter <jerry@samba.org>
@ -172,6 +172,10 @@ $(PSDIR)/%.ps: $(DVIDIR)/%.dvi
xslt/figures/%.pdf: xslt/figures/%.eps
$(EPSTOPDF) $<
# RTF files
$(RTFDIR)/%.rtf: $(DOCBOOKDIR)/%.xml
$(XSLTPROC) --output $@ http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl $<
# Fo
$(FODIR)/%.fo: $(DOCBOOKDIR)/%.xml
mkdir -p $(@D)
@ -190,7 +194,7 @@ $(HTMLHELPDIR)/%: $(DOCBOOKDIR)/%.xml
# Plucker docs
$(PLUCKERDIR)/%.pdb: $(HTMLDIR)/%.html
mkdir -p $(@D)
$(PLUCKERBUILD) -v -M1 --stayonhost --noimages --zlib-compression -H file:$< -f $* -p $(PLUCKERDIR)
$(PLUCKERBUILD) -v -V 2 --stayonhost --zlib-compression -f $* -p $(PLUCKERDIR) file:$<
# Manpages
$(MANPAGEDIR)/smb.conf.5.xml: $(SMBDOTCONFDOC)/parameters.all.xml $(SMBDOTCONFDOC)/parameters.service.xml $(SMBDOTCONFDOC)/parameters.global.xml
@ -241,7 +245,7 @@ undocumented: $(SMBDOTCONFDOC)/parameters.all.xml scripts/find_missing_doc.pl sc
# Examples and the like
files: $(HOWTODIR)/index.xml xslt/extract-smbfiles.xsl
files: Samba-HOWTO-Collection/index.xml xslt/extract-smbfiles.xsl
$(XSLTPROC) xslt/extract-smbfiles.xsl $< > /dev/null
samples: $(DOCBOOKDIR)/Samba-HOWTO-Collection.xml xslt/extract-examples.xsl scripts/indent-smb.conf.pl

4
docs/aclocal.m4 vendored
View File

@ -44,6 +44,7 @@ dnl arg3: variable to store found path in
dnl arg4: target that requires it
AC_DEFUN(DOCS_TARGET_REQUIRE_DIR, [
AC_MSG_CHECKING([for $2])
AC_SUBST($3)
for I in $1;
do
@ -56,5 +57,8 @@ AC_DEFUN(DOCS_TARGET_REQUIRE_DIR, [
else
$4_REQUIRES="$$4_REQUIRES $3"
fi
AC_MSG_RESULT([not found])
else
AC_MSG_RESULT([found in $$3])
fi
])

2
docs/configure.in
View File

@ -68,7 +68,7 @@ DOCS_TARGET_REQUIRE_PROGRAM(HTML2TEXT, html2text, TXT)
DOCS_TARGET_REQUIRE_PROGRAM(PERL, perl, UNDOCUMENTED)
DOCS_TARGET_REQUIRE_PROGRAM(XMLLINT, xmllint, VERIFY)
DOCS_TARGET_REQUIRE_PROGRAM(FOP, fop, FOPDF)
DOCS_TARGET_REQUIRE_DIR([$SPECIFIED_SOURCEDIR ..], [source/configure.in], SAMBASOURCEDIR, UNDOCUMENTED)
DOCS_TARGET_REQUIRE_DIR([$SPECIFIED_SOURCEDIR $SPECIFIED_SOURCEDIR/source ..], [param/loadparm.c], SAMBASOURCEDIR, UNDOCUMENTED)
AC_MSG_RESULT([])
AC_MSG_RESULT([Summary:])

6
docs/scripts/find_missing_doc.pl
View File

@ -27,7 +27,7 @@ chdir($curdir);
# Reading entries from source code
open(SOURCE,"$topdir/source/param/loadparm.c") or die("Can't open $topdir/source/param/loadparm.c: $!");
open(SOURCE,"$topdir/param/loadparm.c") or die("Can't open $topdir/param/loadparm.c: $!");
while ($ln = <SOURCE>) {
last if $ln =~ m/^static\ struct\ parm_struct\ parm_table.*/;
@ -42,7 +42,7 @@ while ($ln = <SOURCE>) {
if($doc{lc($1)}) {
$doc{lc($1)} = "FOUND";
} else {
print "$1 is not documented!\n";
print "'$1' is not documented\n";
}
}
close SOURCE;
@ -52,6 +52,6 @@ close SOURCE;
foreach (keys %doc) {
if($doc{$_} cmp "FOUND") {
print "$_ is documented but is not a configuration option!\n";
print "'$_' is documented but is not a configuration option\n";
}
}

4
docs/scripts/find_missing_manpages.pl
View File

@ -8,7 +8,7 @@ $topdir = (shift @ARGV) or $topdir = ".";
$progs = "";
open(IN, "$topdir/source/Makefile.in");
open(IN, "$topdir/Makefile.in");
while(<IN>) {
if($invar && /^([ \t]*)(.*?)([\\])$/) {
$progs.=" " . $2;
@ -34,6 +34,6 @@ foreach(split(/bin\//, $progs)) {
}
if(!$found) {
print "$f doesn't have a manpage!\n";
print "'$f' does not have a manpage\n";
}
}

2
docs/xslt/extract-smbfiles.xsl
View File

@ -21,7 +21,7 @@
<xsl:apply-templates/>
</xsl:variable>
<!-- Now put varlistentry into separate file _if_ it has anchor associated with it -->
<xsl:variable name="filename"><xsl:text>examples/</xsl:text><xsl:value-of select="@name"/></xsl:variable>
<xsl:variable name="filename"><xsl:text>output/examples/</xsl:text><xsl:value-of select="@name"/></xsl:variable>
<!-- Debug message for an operator, just to show progress of processing :) -->
<xsl:message>
<xsl:text>Writing </xsl:text>