Robert Dodier wrote:
> On 11/4/11, Michel Talon <talon at lpthe.jussieu.fr> wrote:
>
>> On the other hand the documentation on maxima web site doesn't have this
>> problem. Could someone explain what is the procedure to get a complete
>> documentation? There seems to be invocation of perl, python and so on to
>> produce these references, but i have no idea of the good procedure.
>
> "make html" in maxima/doc/info invokes Perl etc. to create the html
> documentation.
>
> Feel free to post whatever error messages you're getting.
>
> best
>
> Robert Dodier
There are so many error messages that it is tedious. First, i have perl and
python accessible in my path. Below i transcript a much abbreviated version:
(the main point is that the end result, the html files, has the same flaw as
in the precompiled version available in maxima site):
lilas% rm *.html
lilas% make html
sh extract_categories.sh maxima
+ TARGET_TEXI=maxima.texi
++ mktemp -d /var/folders/wb/k4m6pmh57m3_6j248b_ftk7h0000gn/T//maxima-texinfo-
categories-XXXXXX
+ WORKING_DIRECTORY=/var/folders/wb/k4m6pmh57m3_6j248b_ftk7h0000gn/T//maxima-t
exinfo-categories-sbXhW4
+ cp -R Affine.texi Arrays.texi Atensor.texi Bugs.texi Command.texi
Constants.texi Contexts.texi Ctensor.texi DataTypes.texi Database.texi
Debugging.texi Deleted.texi Differential.texi Differentiation.texi
Elliptic.texi Equations.texi Evaluation.texi Expressions.texi Floating.texi
Function.texi Groups.texi Help.texi Indices.texi Input.texi ?.
?..
+ for f in '*.texi'
+ '[' zeilberger.texi = maxima.texi ']'
+ sed 's/^@def\(fn\|vr\) *{[^}]*} *\([^[:blank:]]*\).*/@anchor{Item: \2}\
\0/; s/^@node *\([^,]*\).*/@anchor{Item: \1}\
\0/' zeilberger.texi
+ mv tmp.texi zeilberger.texi
+ awk '!/^@c / && !/^@c$/ && (/^@deffn/ || /^@defvr/ || /^@end deffn/ ||
/^@end defvr/ || /@category/ || /@node/)'
+ sed -f
/Users/michel/Documents/maxima/maxima-5.25.1/doc/info/extract_categories1.sed
+ awk '-F$' -f
/Users/michel/Documents/maxima/maxima-5.25.1/doc/info/extract_categories1.awk
+ cat Affine.texi Arrays.texi Atensor.texi Bugs.texi Command.texi
Constants.texi Contexts.texi Ctensor.texi DataTypes.texi Database.texi
Debugging.texi Deleted.texi Differential.texi Differentiation.texi
Elliptic.texi Equations.texi Evaluation.texi Expressions.texi Floating.texi
Function.texi Groups.texi Help.texi Indices.texi Input.texi Integration.texi
Introduction.texi Itensor.texi Limits.texi Lists.texi Logarithms.texi
MathFunctions.texi Matrices.texi Miscellaneous.texi Number.texi Numerical.texi
Operators.texi Plotting.texi Polynomials.texi Program.texi Rules.texi
Runtime.texi Series.texi Simplification.texi Special.texi Symmetries.texi
Trigonometric.texi asympa.texi augmented_lagrangian.texi bernstein.texi
bode.texi category-macros.texi cobyla.texi contrib_ode.texi defstruct.texi
descriptive.texi diag.texi distrib.texi draw.texi drawdf.texi dynamics.texi
ezunits.texi f90.texi finance.texi fractals.texi ggf.texi graphs.texi
grobner.texi impdiff.texi implicit_plot.texi include-maxima.texi interpol.texi
lapack.texi lbfgs.texi lindstedt.texi linearalgebra.texi lsquares.texi
makeOrders.texi maxima.texi minpack.texi mnewton.texi nset.texi
numericalio.texi opsubst.texi orthopoly.texi plotdf.texi romberg.texi
simplex.texi simplifications.texi solve_rec.texi stats.texi stirling.texi
stringproc.texi to_poly_solve.texi unit.texi zeilberger.texi
+ python tmp-make-categories.py
File "tmp-make-categories.py", line 23
@deffn {Function} fast_linsolve ([@var{expr_1}, ..., @var{expr_m}],
[@var{x_1}, ..., @var{x_n}])
^
SyntaxError: invalid syntax
+ sed 's/^@bye//' maxima.texi
+ echo '@node Documentation Categories'
+ echo '@chapter Documentation Categories'
+ for f in 'Category-*.texi'
+ echo @include 'Category-*.texi'
+ echo @bye
+ mv tmp-target.texi maxima.texi
+ perl /Users/michel/Documents/maxima/maxima-5.25.1/doc/info/texi2html
-split_chapter --lang=en --output=.
--css-include=/Users/michel/Documents/maxima/maxima-5.25.1/doc/info/manual.css
--init-file
/Users/michel/Documents/maxima/maxima-5.25.1/doc/info/texi2html.init
maxima.texi
*** Can't find Category-*.texi, skipping (l. 7)
** menu entry without previous node: Introduction to Maxima (in
./include-maxima.texi l. 88)
** menu entry without previous node: Bug Detection and Reporting (in
./include-maxima.texi l. 89)
** menu entry without previous node: Help (in ./include-maxima.texi l. 90)
** menu entry without previous node: Command Line (in ./include-maxima.texi l.
91)
** menu entry without previous node: Data Types and Structures (in
./include-maxima.texi l. 92)
** menu entry without previous node: Expressions (in ./include-maxima.texi l.
93)
** menu entry without previous node: Operators (in ./include-maxima.texi l.
94)
** menu entry without previous node: Evaluation (in ./include-maxima.texi l.
95)
** menu entry without previous node: Simplification (in ./include-maxima.texi
l. 96)
** menu entry without previous node: Mathematical Functions (in
./include-maxima.texi l. 97) ??
** menu entry without previous node: Functions and Variables for strings (in
./stringproc.texi l. 5)
** menu entry without previous node: Functions and Variables for to_poly_solve
(in ./to_poly_solve.texi l. 2)
** menu entry without previous node: Introduction to Units (in ./unit.texi l.
2)
** menu entry without previous node: Functions and Variables for Units (in
./unit.texi l. 3)
** menu entry without previous node: Introduction to zeilberger (in
./zeilberger.texi l. 2)
** menu entry without previous node: Functions and Variables for zeilberger
(in ./zeilberger.texi l. 3)
*** Unknown node in menu entry `Introduction to Maxima' (in
./include-maxima.texi l. 88)
*** Unknown node in menu entry `Bug Detection and Reporting' (in
./include-maxima.texi l. 89)
*** Unknown node in menu entry `Help' (in ./include-maxima.texi l. 90)
*** Unknown node in menu entry `Command Line' (in ./include-maxima.texi l. 91)
*** Unknown node in menu entry `Data Types and Structures' (in
./include-maxima.texi l. 92)
*** Unknown node in menu entry `Expressions' (in ./include-maxima.texi l. 93)
*** Unknown node in menu entry `Operators' (in ./include-maxima.texi l. 94)
*** Unknown node in menu entry `Evaluation' (in ./include-maxima.texi l. 95)
*** Unknown node in menu entry `Simplification' (in ./include-maxima.texi l.
96)
*** Unknown node in menu entry `Mathematical Functions' (in
./include-maxima.texi l. 97)
?.
*** Unknown node in menu entry `Functions and Variables for to_poly_solve' (in
./include-maxima.texi l. 635)
*** Unknown node in menu entry `Introduction to Units' (in
./include-maxima.texi l. 639)
*** Unknown node in menu entry `Functions and Variables for Units' (in
./include-maxima.texi l. 640)
*** Unknown node in menu entry `Introduction to zeilberger' (in
./include-maxima.texi l. 644)
*** Unknown node in menu entry `Functions and Variables for zeilberger' (in
./include-maxima.texi l. 645)
*** Undefined node `Category: Help' in @ref (in ./Introduction.texi l. 194 in
category)
*** Unknown node in menu entry `Functions and Variables for Bug Detection and
Reporting' (in ./Bugs.texi l. 2)
*** Undefined node `Category: Debugging' in @ref (in ./Bugs.texi l. 53 in
category)
*** Undefined node `Category: Debugging' in @ref (in ./Bugs.texi l. 78 in
category)
*** Undefined node `Category: Global variables' in @ref (in ./Bugs.texi l. 78
in category)
*** Undefined node `Category: Debugging' in @ref (in ./Bugs.texi l. 96 in
category)
*** Undefined node `Category: Debugging' in @ref (in ./Bugs.texi l. 110 in
category)
*** Unknown node in menu entry `Documentation' (in ./Help.texi l. 2)
*** Unknown node in menu entry `Functions and Variables for Help' (in
./Help.texi l. 3)
?.
*** Undefined node `Category: Package zeilberger' in @ref (in
./zeilberger.texi l. 414 in category)
*** Undefined node `Category: Package zeilberger' in @ref (in
./zeilberger.texi l. 426 in category)
*** Undefined node `Category: Package zeilberger' in @ref (in
./zeilberger.texi l. 437 in category)
*** Undefined node `Category: Package zeilberger' in @ref (in
./zeilberger.texi l. 449 in category)
+ for f in '*.html'
+ grep -q '<a href=".*">Category: .*</a>' maxima.html
+ '[' 1 = 0 ']'
+ for f in '*.html'
+ grep -q '<a href=".*">Category: .*</a>' maxima_1.html
+ '[' 1 = 0 ']'
+ for f in '*.html'
+ grep -q '<a href=".*">Category: .*</a>' maxima_10.html
+ '[' 1 = 0 ']'
+
?.
+ for f in '*.html'
+ grep -q '<a href=".*">Item: .*</a>' maxima_toc.html
+ '[' 1 = 0 ']'
+ mv maxima.html maxima_1.html maxima_10.html maxima_100.html maxima_11.html
maxima_12.html maxima_13.html maxima_14.html maxima_15.html maxima_16.html
maxima_17.html maxima_18.html maxima_19.html maxima_2.html maxima_20.html
maxima_21.html maxima_22.html maxima_23.html maxima_24.html maxima_25.html
maxima_26.html maxima_27.html maxima_28.html maxima_29.html maxima_3.html
maxima_30.html maxima_31.html maxima_32.html maxima_33.html maxima_34.html
maxima_35.html maxima_36.html maxima_37.html maxima_38.html maxima_39.html
maxima_4.html maxima_40.html maxima_41.html maxima_42.html maxima_43.html
maxima_44.html maxima_45.html maxima_46.html maxima_47.html maxima_48.html
maxima_49.html maxima_5.html maxima_50.html maxima_51.html maxima_52.html
maxima_53.html maxima_54.html maxima_55.html maxima_56.html maxima_57.html
maxima_58.html maxima_59.html maxima_6.html maxima_60.html maxima_61.html
maxima_62.html maxima_63.html maxima_64.html maxima_65.html maxima_66.html
maxima_67.html maxima_68.html maxima_69.html maxima_7.html maxima_70.html
maxima_71.html maxima_72.html maxima_73.html maxima_74.html maxima_75.html
maxima_76.html maxima_77.html maxima_78.html maxima_79.html maxima_8.html
maxima_80.html maxima_81.html maxima_82.html maxima_83.html maxima_84.html
maxima_85.html maxima_86.html maxima_87.html maxima_88.html maxima_89.html
maxima_9.html maxima_90.html maxima_91.html maxima_92.html maxima_93.html
maxima_94.html maxima_95.html maxima_96.html maxima_97.html maxima_98.html
maxima_99.html maxima_abt.html maxima_fot.html maxima_ovr.html maxima_toc.html
/Users/michel/Documents/maxima/maxima-5.25.1/doc/info
+ cd /Users/michel/Documents/maxima/maxima-5.25.1/doc/info
+ set +x
perl ./create_index
< end of the make html command >
--
Michel Talon