[OpenAFS-Doc] Re: OpenAFS Master Repository branch, master, updated. openafs-devel-1_5_62-48-gd6df1a8

[Jason Edgecombe]

commit d6df1a8cec39edf7c0d2598921c735ac6aca70d7
Date: Fri Aug 21 18:12:39 2009 -0700
Move restorevol to bin from sbin
restorevol only requires access to a dump file and write access to the
directory in which the dump is being unpacked. It doesn't require being
a superuser, so it should be installed in bin instead of sbin. Also
move the man page to section 1 and update references accordingly.
Reviewed-on: http://gerrit.openafs.org/333
doc/man-pages/pod1/restorevol.pod | 153 ++++++++++++++++++++++++++++++++++
doc/man-pages/pod1/vos_dump.pod | 2 +-
doc/man-pages/pod1/vos_restore.pod | 2 +-
doc/man-pages/pod8/read_tape.pod | 2 +-
doc/man-pages/pod8/restorevol.pod | 153 ----------------------------------
doc/man-pages/pod8/voldump.pod | 2 +-
src/packaging/RedHat/openafs.spec.in | 4 +-
src/volser/Makefile.in | 2 +-
8 files changed, 160 insertions(+), 160 deletions(-)

I noticed that the restorevol file in the man8 folder. The files in the
man* folders say that they were autogenerated by pod2man. When do the
files in man* get updated? If they were generated automatically, then
should they even be in git?

Thanks,
Jason

[Russ Allbery]

Post by Jason Edgecombe
I noticed that the restorevol file in the man8 folder. The files in the
man* folders say that they were autogenerated by pod2man. When do the
files in man* get updated? If they were generated automatically, then
should they even be in git?

They're not. They're generated by regen.sh. The old file won't be
deleted by the build system unless you run make maintclean.

[Jeffrey Altman]

Post by Jason Edgecombe
I noticed that the restorevol file in the man8 folder. The files in
the man* folders say that they were autogenerated by pod2man. When do
the files in man* get updated? If they were generated automatically,
then should they even be in git?

The are generated manually and the doc files in the repository are not
used any more.

[Jason Edgecombe]

Post by Jeffrey Altman

Post by Jason Edgecombe
I noticed that the restorevol file in the man8 folder. The files in
the man* folders say that they were autogenerated by pod2man. When do
the files in man* get updated? If they were generated automatically,
then should they even be in git?

The are generated manually and the doc files in the repository are not
used any more.

Should the man* folders be removed?

Jason

[Jeffrey Altman]

Post by Jason Edgecombe

Post by Jeffrey Altman

Post by Jason Edgecombe
I noticed that the restorevol file in the man8 folder. The files in
the man* folders say that they were autogenerated by pod2man. When do
the files in man* get updated? If they were generated automatically,
then should they even be in git?

The are generated manually and the doc files in the repository are not
used any more.

Should the man* folders be removed?
Jason

It doesn't matter as far as I'm concerned.
They were only there because putting them there was the only way to
ensure that they would be pushed to the web site when the web site was
rebuilt.

[Jason Edgecombe]

Post by Jeffrey Altman

Post by Jason Edgecombe

Post by Jeffrey Altman

Post by Jason Edgecombe
I noticed that the restorevol file in the man8 folder. The files in
the man* folders say that they were autogenerated by pod2man. When do
the files in man* get updated? If they were generated automatically,
then should they even be in git?

The are generated manually and the doc files in the repository are not
used any more.

Should the man* folders be removed?
Jason

It doesn't matter as far as I'm concerned.
They were only there because putting them there was the only way to
ensure that they would be pushed to the web site when the web site was
rebuilt.

So... what would the impact be of removing them?

How about we just remove the contents of the folders?

Jason

[Jason Edgecombe]

Post by Jason Edgecombe

Post by Jason Edgecombe

Post by Jeffrey Altman

Post by Jason Edgecombe
I noticed that the restorevol file in the man8 folder. The files in
the man* folders say that they were autogenerated by pod2man. When do
the files in man* get updated? If they were generated automatically,
then should they even be in git?

The are generated manually and the doc files in the repository are not
used any more.

Should the man* folders be removed?
Jason

It doesn't matter as far as I'm concerned. They were only there
because putting them there was the only way to
ensure that they would be pushed to the web site when the web site was
rebuilt.

So... what would the impact be of removing them?
How about we just remove the contents of the folders?

Never mind. Those folders aren't in git ;P

Jason