[ptxdist] help broken again since 2016.10.0

[ptxdist] help broken again since 2016.10.0

[Alexander Dahl]

Hei hei,

while searching how to build the new documentation (btw: I could not
find out) I stumbled over the broken help. Results from different
ptxdist versions:


adahl@ada ~/src % ptxdist-2016.11.0 help
man: /usr/local/lib/ptxdist-2016.11.0/man/ptxdist.1.gz: No such file or
directory

adahl@ada ~/src % ptxdist-2016.10.0 help
man: /usr/local/lib/ptxdist-2016.10.0/man/ptxdist.1.gz: No such file or
directory

ptxdist-2016.09.0: new man page shows up

ptxdist-2016.08.0: new man page shows up

adahl@ada ~/src % ptxdist-2016.07.0 help
man: /usr/local/lib/ptxdist-2016.07.0/man/ptxdist.1.gz: No such file or
directory

adahl@ada ~/src % ptxdist-2016.06.0 help
man: /usr/local/lib/ptxdist-2016.06.0/man/ptxdist.1.gz: No such file or
directory

adahl@ada ~/src % ptxdist-2016.05.0 help
man: /usr/local/lib/ptxdist-2016.05.0/man/ptxdist.1.gz: No such file or
directory

adahl@ada ~/src % ptxdist-2016.04.0 help
man: /usr/local/lib/ptxdist-2016.04.0/man/ptxdist.1.gz: No such file or
directory

adahl@ada ~/src % ptxdist-2016.02.0 help
man: /usr/local/lib/ptxdist-2016.02.0/man/ptxdist.1.gz: No such file or
directory

adahl@ada ~/src % ptxdist-2016.01.0 help
man: /usr/local/lib/ptxdist-2016.01.0/man/ptxdist.1.gz: No such file or
directory

adahl@ada ~/src % ptxdist-2015.12.0 help
man: /usr/local/lib/ptxdist-2015.12.0/man/ptxdist.1.gz: No such file or
directory

ptxdist-2015.10.0: old plaintext help shows up

ptxdist-2015.09.0: old plaintext help shows up

ptxdist-2015.08.0: old plaintext help shows up

ptxdist-2015.07.0: old plaintext help shows up


The file ptxdist.1.gz is only available in the folders of 2016.08.0 and
2016.09.0 and missing in all the others. I usually install like this:

* go to ptxdist src folder (git clone)
* git co ptxdist-201?-??-?
* git clean -dxf
* ./autogen.sh
* ./configure
* make
* sudo make install

In the current master no man page is created with a simple `make`, I
would have to call `make man`, not sure if it gets installed, though,
didn't test it.

Greets
Alex

-- 
»With the first link, the chain is forged. The first speech censured,
the first thought forbidden, the first freedom denied, chains us all
irrevocably.« (Jean-Luc Picard, quoting Judge Aaron Satie)
*** GnuPG-FP: C28E E6B9 0263 95CF 8FAF  08FA 34AD CD00 7221 5CC6 ***

_______________________________________________
ptxdist mailing list
ptxdist@pengutronix.de

Re: [ptxdist] help broken again since 2016.10.0

[Michael Olbrich]

Hi,

On Wed, Nov 23, 2016 at 09:48:39AM +0100, Alexander Dahl wrote:
> while searching how to build the new documentation (btw: I could not
> find out) I stumbled over the broken help. Results from different
> ptxdist versions:
> 
[...]
> 
> The file ptxdist.1.gz is only available in the folders of 2016.08.0 and
> 2016.09.0 and missing in all the others. I usually install like this:
> 
> * go to ptxdist src folder (git clone)
> * git co ptxdist-201?-??-?
> * git clean -dxf
> * ./autogen.sh
> * ./configure
> * make
> * sudo make install
> 
> In the current master no man page is created with a simple `make`, I
> would have to call `make man`, not sure if it gets installed, though,
> didn't test it.

This was a deliberate change and I'm not quite sure how to improve the
situation.
I did not want to make rst2man a hard requirement for ptxdist. So all
tarball releases contain the man-page.

I suppose we could create the man page under certain circumstances during
'make'. What should the condition be? If rst2man is found? When working
with a ptxdist git checkout?

Regards,
Michael

-- 
Pengutronix e.K.                           |                             |
Industrial Linux Solutions                 | http://www.pengutronix.de/  |
Peiner Str. 6-8, 31137 Hildesheim, Germany | Phone: +49-5121-206917-0    |
Amtsgericht Hildesheim, HRA 2686           | Fax:   +49-5121-206917-5555 |

_______________________________________________
ptxdist mailing list
ptxdist@pengutronix.de

Re: [ptxdist] help broken again since 2016.10.0

[Uwe Kleine-König]

On Thu, Dec 01, 2016 at 11:02:45AM +0100, Michael Olbrich wrote:
> Hi,
> 
> On Wed, Nov 23, 2016 at 09:48:39AM +0100, Alexander Dahl wrote:
> > while searching how to build the new documentation (btw: I could not
> > find out) I stumbled over the broken help. Results from different
> > ptxdist versions:
> > 
> [...]
> > 
> > The file ptxdist.1.gz is only available in the folders of 2016.08.0 and
> > 2016.09.0 and missing in all the others. I usually install like this:
> > 
> > * go to ptxdist src folder (git clone)
> > * git co ptxdist-201?-??-?
> > * git clean -dxf
> > * ./autogen.sh
> > * ./configure
> > * make
> > * sudo make install
> > 
> > In the current master no man page is created with a simple `make`, I
> > would have to call `make man`, not sure if it gets installed, though,
> > didn't test it.
> 
> This was a deliberate change and I'm not quite sure how to improve the
> situation.
> I did not want to make rst2man a hard requirement for ptxdist. So all
> tarball releases contain the man-page.
> 
> I suppose we could create the man page under certain circumstances during
> 'make'. What should the condition be? If rst2man is found? When working
> with a ptxdist git checkout?

Isn't this what --enable-maintainer-mode is supposed to do? I.e. in
maintainer-mode regerate everything, and otherwise use shipped files.

Best regards
Uwe

-- 
Pengutronix e.K.                           | Uwe Kleine-König            |
Industrial Linux Solutions                 | http://www.pengutronix.de/  |

_______________________________________________
ptxdist mailing list
ptxdist@pengutronix.de