Bug 206105

Summary:	man pages could not install from sources
Product:	Documentation	Reporter:	Pavel <psergeevich>
Component:	Books & Articles	Assignee:	freebsd-doc (Nobody) <doc>
Status:	Closed Not A Bug
Severity:	Affects Many People	CC:	psergeevich, wblock
Priority:	---
Version:	Latest
Hardware:	Any
OS:	Any

Description Pavel 2016-01-10 17:56:38 UTC

-----------I fetched clean copy of man pages sources:

# svnlite checkout https://svn.FreeBSD.org/doc/head/https://svn.freebsd.org/doc/head/ru_RU.KOI8-R/man /usr/doc/ru_RU.KOI8-R/man

------------...then I tried to install man pages from sources:

# cd /usr/doc/ru_RU.KOI8-R/man
# make install clean
mkdir -p /usr/share/man/ru_RU.KOI8-R
mtree -deU -f /usr/doc/ru_RU.KOI8-R/man/FRDP.man.dist -p /usr/share/man/ru_RU.KOI8-R
===> man1 (install)
install -o root -g wheel -m 444 apply.1.gz  /usr/share/man/ru_RU.KOI8-R/man1
install: apply.1.gz: No such file or directory
*** Error code 71

Stop.
make[1]: stopped in /usr/doc/ru_RU.KOI8-R/man/man1
*** Error code 1

Stop.
make: stopped in /usr/doc/ru_RU.KOI8-R/man

------------------ Man pages has not been installed, because installer looking for *.gz archives, which are absent in the sources. I solved the problem by simple copying man files from the sources to /usr/share/man/ru_RU.KOI8-R/. Another language man pages sources have the same problem. Man pages sources (or Handbook 23.3.1 https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/updating-upgrading-documentation.html) needs correction.

Comment 1 Warren Block freebsd_committer

2016-01-10 19:48:33 UTC

Is this a documentation bug, or a problem with the Makefile?  Can you be more specific about what corrections need to be made?

Comment 2 Pavel 2016-01-11 02:02:15 UTC

(In reply to Warren Block from comment #1)
I think, this is a problem with the Makefile.

Comment 3 Pavel 2016-01-11 02:17:03 UTC

(In reply to Warren Block from comment #1)
I learning FreeBSD with online Handbook, and don't know Makefile's work very well yet. But I think, if installation algorithm in Makefile looking for gzipped man pages sources, they have to be placed in source folders in gzip archives.

Comment 4 Warren Block freebsd_committer

2016-01-13 17:46:31 UTC

This is not a ports problem, it is with documentation.  But it could be the documentation of the process, or part of the documentation build system.  The linked page does not mention doing a partial checkout of the doc tree just for man pages, and as far as I know, that is not supported.  Could you show which portion of the documentation you were following that suggested that method?

Comment 5 Pavel 2016-01-16 14:53:36 UTC

(In reply to Warren Block from comment #4)
I have checkout whole doc tree:
# rm -r /usr/doc
# svn checkout https://svn.FreeBSD.org/doc/head /usr/doc

I found man pages шт different languages in sources directories. I hoped, that documentation update process also will install these man pages.
Then I have full update documentation of all available languages:
# cd /usr/doc
# make install clean

Man pages were not installed. My suggestions were wrong.
I have not found references about installing man pages in different languages from sources in Handbook.
It's not bug of documentation and not bug of documentation build process.
I think Status can be changed to "Closed"