[gnuastro-commits] master 253174d4: Book: known issue added for "Numeric user ID too large" in make dist

[Mohammad Akhlaghi]

branch: master
commit 253174d488fb45af12045be07e98646648b12145
Author: Raul Infante-Sainz <infantesainz@gmail.com>
Commit: Mohammad Akhlaghi <mohammad@akhlaghi.org>

    Book: known issue added for "Numeric user ID too large" in make dist
    
    Until now, in some operating systems and under some special circumnstances,
    we were not able to create the Gnuastro distribution tarball with "make
    dist".  This problem is related to Tar and how Automake calls it. For more
    information see https://savannah.gnu.org/bugs/index.php?65578
    
    With this commit, a manual work-around has been added to the "known issues"
    section of the book so the users can generate the Gnuastro tarball until it
    is fixed. This temporary fix is thanks to the discussions with Mohammad
    Akhlaghi and Giacomo Lorenzetti.
---
 doc/gnuastro.texi | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/doc/gnuastro.texi b/doc/gnuastro.texi
index c425e0b5..aca4dda7 100644
--- a/doc/gnuastro.texi
+++ b/doc/gnuastro.texi
@@ -13593,6 +13593,38 @@ But this may be disabled with the following (or a 
similar) lines in @code{/etc/I
 
 To fix this problem, simply comment such lines (by placing a @code{<!--} 
before each statement/line and @code{-->} at the end of that statement/line).
 
+@item
+@command{$ make dist}: @emph{Complains about "Numeric user ID too large" and 
aborts.} This is a problem related to the way that GNU Automake calls GNU Tar 
on some operating systems.
+For more information see bug 
65578@footnote{@url{https://savannah.gnu.org/bugs/index.php?65578}}.
+Until this bug is fixed, you can build the tarball by following the steps 
below:
+
+@example
+## Generate the build directory; ready to be packaged.
+$ ./developer-build -a -c -d -C
+
+## Go to the build directory:
+$ cd build
+@end example
+
+Open and edit the @file{Makefile} to add @code{--format=posix} to the 
definition of the @code{am__tar}.
+So, the line
+
+@example
+am__tar = $$@{TAR-tar@} chof - "$$tardir"
+@end example
+
+becomes
+
+@example
+am__tar = $$@{TAR-tar@} --format=posix chof - "$$tardir"
+@end example
+
+Finally, create the tarball:
+@example
+$ make dist
+@end example
+
+
 @end itemize
 
 @noindent