1
0
mirror of https://github.com/samba-team/samba.git synced 2024-12-23 17:34:34 +03:00
Commit Graph

49 Commits

Author SHA1 Message Date
Joseph Sutton
af2b5f46b9 docs-xml: Fix code spelling
Signed-off-by: Joseph Sutton <josephsutton@catalyst.net.nz>
Reviewed-by: Andrew Bartlett <abartlet@samba.org>
2023-12-08 02:28:33 +00:00
Andrew Bartlett
45094bd891 docs-xml: Use &pathconfig.WINBINDD_SOCKET_DIR; to avoid reference to old /tmp/.winbindd
We can now write docs that follow how the software on this system was
built, which is much less confusing for users.  Also /tmp/.winbindd
has not been used for a long time.

BUG: https://bugzilla.samba.org/show_bug.cgi?id=15101

Signed-off-by: Andrew Bartlett <abartlet@samba.org>
Reviewed-by: Andreas Schneider <asn@samba.org>
2022-06-22 15:50:33 +00:00
Andrew Bartlett
0208d5f64b Add docs build to CI
We did not check we could actually build the HTML of the
Samba Developers guide and HTML of the manpages previously.

Signed-off-by: Andrew Bartlett <abartlet@samba.org>
Reviewed-by: David Disseldorp <ddiss@samba.org>

Autobuild-User(master): Andrew Bartlett <abartlet@samba.org>
Autobuild-Date(master): Wed Jun 10 07:11:59 UTC 2020 on sn-devel-184
2020-06-10 07:11:59 +00:00
Andrew Bartlett
4a3ed0d845 docs-xml: Remove GNU TexInfo build
This does not build and is not a common or required format for
documentation any more.

Signed-off-by: Andrew Bartlett <abartlet@samba.org>
Reviewed-by: David Disseldorp <ddiss@samba.org>
2020-06-10 05:44:37 +00:00
Andrew Bartlett
9392c3f81c docs-xml: Remove references to inkscape (not used any more, no more SVG files)
Signed-off-by: Andrew Bartlett <abartlet@samba.org>
Reviewed-by: David Disseldorp <ddiss@samba.org>
2020-06-10 05:44:37 +00:00
Andrew Bartlett
ccb606c469 docs-xml: Remove final references to Samba3-HOWTO and Samba3-ByExample
Signed-off-by: Andrew Bartlett <abartlet@samba.org>
Reviewed-by: David Disseldorp <ddiss@samba.org>
2020-06-10 05:44:37 +00:00
Andrew Bartlett
cedd00fdff docs-xml: Remove references to building docs using Plucker
This was for Palm OS based handheld devices, Windows Mobile devices, and other PDAs...

Signed-off-by: Andrew Bartlett <abartlet@samba.org>
Reviewed-by: David Disseldorp <ddiss@samba.org>
2020-06-10 05:44:37 +00:00
Björn Jacke
3cbeaf4093 docs-xml: add basic Makefile dependencies for targets that use xsltproc
Signed-off-by: Bjoern Jacke <bjacke@samba.org>
Reviewed-by: Karolin Seeger <kseeger@samba.org>

Autobuild-User(master): Björn Jacke <bj@sernet.de>
Autobuild-Date(master): Fri Jan  5 19:55:29 CET 2018 on sn-devel-144
2018-01-05 19:55:29 +01:00
Björn Jacke
9b27948d65 docs-xml: set a reasonable XML_CATALOG_FILES in Makefile
Signed-off-by: Bjoern Jacke <bjacke@samba.org>
Reviewed-by: Karolin Seeger <kseeger@samba.org>
2018-01-05 15:29:13 +01:00
Björn Jacke
a2f5b3b8e1 docs-xml: generate build/catalog.xml via Makefile target
Signed-off-by: Bjoern Jacke <bjacke@samba.org>
Reviewed-by: Karolin Seeger <kseeger@samba.org>
2018-01-05 15:29:13 +01:00
Björn Jacke
e29d31f74f doc-xml: fix dependency as the xml targets depend on Makefile.settings
Signed-off-by: Bjoern Jacke <bjacke@samba.org>
Reviewed-by: Stefan Metzmacher <metze@samba.org>
2018-01-02 13:34:20 +01:00
Bernhard M. Wiedemann via samba-technical
eedebe2ef1 docs-xml: Sort input file list
because filesystems return entries in undeterministic order
and that ends up in index.xml and influences index.html
preventing reproducible builds of samba packages (e.g. for openSUSE)

See https://reproducible-builds.org/ for why this matters

Signed-off-by: Bernhard M. Wiedemann <bwiedemann@suse.de>
Reviewed-by: Andrew Bartlett <abartlet@samba.org>
Reviewed-by: David Disseldorp <ddiss@samba.org>

Autobuild-User(master): David Disseldorp <ddiss@samba.org>
Autobuild-Date(master): Tue Jun 27 16:56:06 CEST 2017 on sn-devel-144
2017-06-27 16:56:05 +02:00
Andrew Bartlett
7ddb58dcd9 docs: Remove unused parameters.global.xml and parameters.service.xml
Signed-off-by: Andrew Bartlett <abartlet@samba.org>
Reviewed-by: Michael Adam <obnox@samba.org>
2014-01-29 09:16:23 +01:00
Andrew Bartlett
12aed897ec docs: Remove find_missing_manpages replaced by docs.py and dependent on a Makefile.in file
Signed-off-by: Andrew Bartlett <abartlet@samba.org>
Reviewed-by: Michael Adam <obnox@samba.org>
2014-01-29 09:16:07 +01:00
Jelmer Vernooij
d2f8fe855d tests: Convert find_missing_doc into a unit test. 2012-10-19 09:10:13 +02:00
Alexander Bokovoy
4a21d2e779 Fix release script to build full set of documentation
build-docs script was not setting XML catalog properly.

In addition, some time ago pdf versions of images were introduced as
generated dependencies in our books but svg -> pdf rule was not added,
so building books never finished properly.

Autobuild-User(master): Alexander Bokovoy <ab@samba.org>
Autobuild-Date(master): Tue Oct  2 16:21:23 CEST 2012 on sn-devel-104
2012-10-02 16:21:23 +02:00
Jelmer Vernooij
718317ecef undocumented: Drop extension from helper scripts. 2012-09-26 07:58:31 +02:00
Michael Adam
ab33691271 docs:build: make target "manpages" .PHONY, so manpages do get built...
Autobuild-User(master): Michael Adam <obnox@samba.org>
Autobuild-Date(master): Mon Sep 10 17:55:20 CEST 2012 on sn-devel-104
2012-09-10 17:55:20 +02:00
Karolin Seeger
54f1ce4c79 docs: Rename htmlman3 -> htmlman.
Karolin

Autobuild-User(master): Karolin Seeger <kseeger@samba.org>
Autobuild-Date(master): Mon Sep 10 14:19:42 CEST 2012 on sn-devel-104
2012-09-10 14:19:42 +02:00
Andrew Bartlett
339fb7ef61 remove extra tab from Makefile 2012-09-04 09:31:49 +10:00
Andrew Bartlett
f9e8f08197 docs: Fix undocumented target to find smb.conf directives in the right place
The manpages target needs to be reworked to know about waf.

Andrew Bartlett
2012-09-04 09:31:49 +10:00
Karolin Seeger
75484f4911 docs: Rename manpages-3 -> manpages.
This change was suggested by Andrew Bartlett on the samba-technical mailing
list.

Karolin

Autobuild-User(master): Karolin Seeger <kseeger@samba.org>
Autobuild-Date(master): Mon Sep  3 23:35:38 CEST 2012 on sn-devel-104
2012-09-03 23:35:37 +02:00
Karolin Seeger
9c44e2e539 s4-docs: Remove empty s4 HOWTO Collection.
This change was proposed by Andrew Bartlett on the samba-technical mailing list.

Karolin
2012-09-03 21:05:22 +02:00
Jelmer Vernooij
a7d5d08191 Revert "Remove XSLT script to generate image dependencies, instead rely on make"
This reverts commit c4493c22f1.

Bug: https://bugzilla.samba.org/show_bug.cgi?id=7562

Conflicts:
	docs-xml/Makefile

Autobuild-User(master): Jelmer Vernooij <jelmer@samba.org>
Autobuild-Date(master): Mon Jul 16 16:18:46 CEST 2012 on sn-devel-104
2012-07-16 16:18:46 +02:00
Michael Adam
82e0ba22ce docs: fix the missing parameter description section in the smb.conf manpage
The smb.conf (5) manpage recently sometimes failed to contain the
contents of the description of each parameter section. The reason
was a unreliable chain of dependencies in the Makefile.

The error can be reproduced by touching manpages-3/smb.conf.5.xml
and then building the manpages.
Then smb.conf.5.xml is newer than any of the smbdotconf/*/*.xml
files and hence the intermediate inexistent parameters.*.xml
don't get generated.

This patch fixes this problem by introducing a phony "parameters"
target referencing the parameters.*.xml targets, so that they
get build unconditionally.

Autobuild-User: Michael Adam <obnox@samba.org>
Autobuild-Date: Wed Apr  6 01:22:00 CEST 2011 on sn-devel-104
2011-04-06 01:22:00 +02:00
Alexander Bokovoy
217e3086c7 Pass absolute file paths to Inkscape when transforming .svg files
Some recent versions of Inkscape (0.47 or around) have bug when export file name
is treated as relative against the directory of original .svg if it wasn't specified
as an absolute path. Fix it by always using absolute paths during conversion.
2009-08-08 08:02:52 +03:00
Jelmer Vernooij
aebb1b8d7c Fix dependency on the attributes file. 2009-05-02 01:15:27 +02:00
Jelmer Vernooij
0163f7ee8b Remove unused entries from clean. 2009-05-02 01:15:26 +02:00
Jelmer Vernooij
fada9e915a Remove rules for unused epstopdf. 2009-05-02 01:15:26 +02:00
Jelmer Vernooij
c4493c22f1 Remove XSLT script to generate image dependencies, instead rely on make
given that the number of image formats we use is limited.
2009-05-02 01:15:26 +02:00
Jelmer Vernooij
86a968b098 Remove text chunks support. Was never built by any of the main targets,
and one of the reasons the complex dependency system exists.
2009-05-02 01:15:26 +02:00
Jelmer Vernooij
df74a0eb78 Remove broken XSL-FO translation code; this has been broken for a while
and the output was never used.
2009-05-01 22:49:13 +02:00
Jelmer Vernooij
62dfc6c517 Generate pdf documents in-place rather than copying them from . to output/ 2009-05-01 22:49:12 +02:00
Jelmer Vernooij
29e696a62b Fix build of the PostScript documents. 2009-05-01 22:49:11 +02:00
Jelmer Vernooij
0edebf5e9a Fix dependencies on images for pdf and ps files. 2009-05-01 22:49:11 +02:00
Jelmer Vernooij
e9bc179e0a Remove unnecessary checks for apps now used through dblatex. 2009-05-01 22:49:11 +02:00
Jelmer Vernooij
64cf630033 Cut out the intermediate dvi files in the Makefile - dblatex can take care
of those for us.
2009-05-01 22:49:09 +02:00
Jelmer Vernooij
b1097e1532 Use system-provided dblatex to build the docs rather than included
db2latex.
2009-05-01 22:49:06 +02:00
Jelmer Vernooij
90c9e0aec4 Fix 'make samples' (git doesn't version directories, so 'examples' won't
exist yet)
2009-05-01 13:10:13 +02:00
Michael Adam
5e21fc3506 s3:docs: clean build/catalog.xml in "make clean"
Michael
2009-01-21 15:12:18 +01:00
Michael Adam
9b32e839be s3:docs: clean generated .png images in "make clean"
Michael
2009-01-21 15:12:17 +01:00
Michael Adam
37412017c5 s3:docs: fix ommission in fix of (real)distclean targets
Michael
2009-01-21 11:47:46 +01:00
Michael Adam
65c92fea3d s3:docs: fix distclean target and add realdistclean target
- remove stuff created by configure in distclean
- remove stuff created by autoconf in realdistclean

Michael
2009-01-21 11:46:35 +01:00
Jelmer Vernooij
5f6d0078d4 Depend on latexfigures files directly as using a rule in between causes problems.
(This used to be commit bf3c2773f9)
2008-05-27 18:40:14 +02:00
Jelmer Vernooij
323be4a690 Use double colon targets.
(This used to be commit 825cf91fa8)
2008-05-21 17:57:30 +02:00
Jelmer Vernooij
0f3ba4b766 Add test target in Makefile.
(This used to be commit ac0d768676)
2008-05-21 17:56:34 +02:00
Jelmer Vernooij
70f52c06ba Make the make output a bit less chatty.
(This used to be commit 1fa4ef553c)
2008-05-21 17:56:31 +02:00
Alexander Bokovoy
3be9a355ff Fix documentation build: manpages, links in the HTML documents.
Fixed manpages generation to properly create handle smb.conf parameters' titles
Changed HTML generator to include links for every smb.conf parameter.
Now we have correct linking between different HTML documents.


Signed-off-by: Alexander Bokovoy <ab@samba.org>
(This used to be commit 056935ff1f)
2008-04-24 23:40:51 +04:00
Gerald W. Carter
8f8a9f0190 Moving docs tree to docs-xml to make room for generated docs in the release tarball.
(This used to be commit 9f672c26d6)
2008-04-23 08:47:48 -05:00