On installation, substitute the configured paths into the man pages,
replacing the Transarc paths. Also fix a problem with the way that
pinstall was being used to install man pages. (Silly me, I was assuming
it had the same behavior as install.)
This is just a quick first pass. Longer term, it's probably better to
replace all paths in the man pages with unambiguous tokens and then
replace those tokens instead of assuming that the man pages use Transarc
paths and replacing those paths specifically. The current method has a
few minor problems, such as not being able to distinguish between the
various paths that make up /usr/afs/bin. Still, the results of this method
are good enough to start with.
(cherry picked from commit 5fde2994348d1c7f6239f98aac355011125b06ad)
Remove all trailing whitespace while we have the chance and there are no
merge issues yet.
(cherry picked from commit 160854bd2bd9994b615216c566473598e871d13b)
Move man page generation out into a separate script that's just invoked
from regen.sh, so that someone can run that separate script later if they
wish. Make that script more robust against problems such as empty podN
directories. Diagnose a missing pod2man and warn about old versions of
Pod::Man.
Also, remove the old programs used to do the initial conversion from HTML.
Enough post-conversion editing was done that they're no longer necessary
except for historical curiosity, and for that purpose they can be pulled
out of CVS.
(cherry picked from commit 0b21e24d0a96401033d55d3c079c954138b7c50e)
This completes the first editing pass of the man pages. Very little
content editing has been done, but the server and client versions of
various man pages have been combined into a single man page for the
file (affects CellServDB, ThisCell, NetInfo, and NetRestrict), the
descriptions of the various AFS cache files have been combined into one
afs_cache man page, and the descriptions of the two butc log files have
been combined into one butc_logs man page.
For man pages for databases with two files, symlinks are now created on
installation for the secondary file name.
All of the man pages should now be ready for public review, additional
editing and cleanup, and content editing.
(cherry picked from commit f64a78e7013ebafd9ce4a0a50822a6087ff62f6c)
This completes the initial editing pass of the section eight man pages.
Only small amounts of content editing has been done. Some known problems
have been noted in README, but there will doubtless be others, as well as
some lingering formatting problems. However, the quality should now be
good enough for general public review.
Some of the section eight man pages were really supposed to be section one,
the package apropros and package help commands are too useless to document,
and a few of the difficult-to-name section five man pages have now acquired
names.
RCS file: /cvs/openafs/doc/man-pages/pod8/Attic/package_apropos.pod,v
Working file: doc/man-pages/pod8/package_apropos.pod
head: 1.2
branch:
locks: strict
access list:
keyword substitution: kv
total revisions: 4; selected revisions: 0
description:
RCS file: /cvs/openafs/doc/man-pages/pod8/Attic/package_help.pod,v
Working file: doc/man-pages/pod8/package_help.pod
head: 1.2
branch:
locks: strict
access list:
keyword substitution: kv
total revisions: 4; selected revisions: 0
description:
RCS file: /cvs/openafs/doc/man-pages/pod8/Attic/package_test.pod,v
Working file: doc/man-pages/pod8/package_test.pod
head: 1.2
branch:
locks: strict
access list:
keyword substitution: kv
total revisions: 4; selected revisions: 0
description:
RCS file: /cvs/openafs/doc/man-pages/pod8/Attic/tapeconfig.pod,v
Working file: doc/man-pages/pod8/tapeconfig.pod
head: 1.2
branch:
locks: strict
access list:
keyword substitution: kv
total revisions: 4; selected revisions: 0
description:
RCS file: /cvs/openafs/doc/man-pages/pod8/Attic/xstat_cm_test.pod,v
Working file: doc/man-pages/pod8/xstat_cm_test.pod
head: 1.2
branch:
locks: strict
access list:
keyword substitution: kv
total revisions: 4; selected revisions: 0
description:
RCS file: /cvs/openafs/doc/man-pages/pod8/Attic/xstat_fs_test.pod,v
Working file: doc/man-pages/pod8/xstat_fs_test.pod
head: 1.2
branch:
locks: strict
access list:
keyword substitution: kv
total revisions: 4; selected revisions: 0
description:
(cherry picked from commit ab4abf15fef60308b982c73b6d1a17fa60577120)
Initial documentation for the man page project, including initial notes
on conversion, a start at a formatting guide, information on how to
contribute, and an initial issues list of things I happened to notice
while editing the section one pages.
(cherry picked from commit d60224477f13bbf6a16d9582040e38d539859518)
Generate the man pages in man1, man5, and man8 subdirectories rather than
directly in the doc/man-pages directory to reduce clutter. Add a
.cvsignore to reduce noise.
(cherry picked from commit 7b5bfb1c1793c488fff06fc9014119a286ec86a7)
This file got the wrong name when it was originally committed. Fix.
RCS file: /cvs/openafs/doc/man-pages/pod5/Attic/afsmonitor.5,v
Working file: doc/man-pages/pod5/afsmonitor.5
head: 1.2
branch:
locks: strict
access list:
keyword substitution: kv
total revisions: 2; selected revisions: 0
description:
(cherry picked from commit 03b9fcc8834bfaaac069b27c0cd919934b68e833)
This is the initial conversion of the AFS Adminstrators Reference into POD
for use as man pages. The man pages are now generated via pod2man from
regen.sh so that only those working from CVS have to have pod2man
available. The Makefile only installs. The pages have also been sorted
out into pod1, pod5, and pod8 directories, making conversion to the right
section of man page easier without maintaining a separate list and allowing
for names to be duplicated between pod5 and pod1 or pod8 (which will likely
be needed in a few cases).
This reconversion is done with a new script based on work by Chas Williams.
In some cases, the output is worse than the previous POD pages, but this is
a more comprehensive conversion.
This is only the first step, and this initial conversion has various
problems. In addition, the file man pages that didn't have simple names
have not been converted in this pass and will be added later. Some of the
man pages have syntax problems and all of them have formatting errors. The
next editing pass, coming shortly, will clean up most of the remaining
mess.
(cherry picked from commit e3dfba8e6c10c296c09e9b0ac0c0355658ce0be7)
remove files whose contents are now maintained in the HTML files
src/WINNT/doc/...
(cherry picked from commit da213bfa2904bdb3899982640822e9434d515b6c)
"fs flushall" is like "fs flushvolume" but flushes all data in the cache
====================
This delta was composed from multiple commits as part of the CVS->Git migration.
The checkin message with each commit was inconsistent.
The following are the additional commit messages.
====================
typo
====================
remove extra patch from duplicate pullup
====================
ugh, one more time
(cherry picked from commit 9e348b344dfe9f3940f099beb2acc208fa90a61c)
Now that OAFW is ready for a stable series, we will default "fs trace"
to off on non-Debug builds. It can be set to on via the TraceOption
registry value. (see registry.txt)
(cherry picked from commit b9fc404bdf16fc3a61f13bffcaadc5d598d02cbd)
alter the afsd_init.log tag for the TraceOption to not be
Windows Event Log specific.
(cherry picked from commit 48b0320b201c2efe153098e8a5a5e4e6470a41c5)
Do not return error codes from the SMB/CIFS server that can be interpretted
by the SMB/CIFS client as meaning that the AFS Client Service is not
available.
(cherry picked from commit eb00f913748ba8651755451120a1f0d06b1e9cd2)
When tokens expire, do not display an obtain tokens dialog if there
is no network connectivity to the kdc for the realm associated with
the cell.
In the en_US build, stop displaying the expiration time of tokens
after the tokens expire.
(cherry picked from commit 7c34c9b5c0fbdf0b9b9429c2e763c635857974ab)
Discovered a deadlock due to a violation of lock order. We may not
attempt to obtain a lock on a cm_scache_t mutex while holding the
cm_aclLock.
(cherry picked from commit f21fa57453f4c94690c56cf4933b4eed82d99edc)
Support for NSIS 2.07 including named installation configurations
and an Icon for the uninstall entry listed in the Add/Remove Programs
control panel.
(cherry picked from commit 4464c62f92541c8b1f46260d6c4cbdd1ba4cf85f)
