Am Freitag, den 04.11.2011, 20:25 +0000 schrieb Michel Talon:
> 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 >
Most messages are generated from the building of the categories. I have
always ignored all these messages. I have cut out the categories for the
German manual, because the categories do not work for the German manual.
Without the categories I get the following with the command `make html':
dieter at dieter:~/Maxima/maxima/doc/info/de$ make html
perl texi2html -split_chapter --lang=de --output=.
--css-include=../manual.css --init-file ../texi2html.init maxima.texi
*** Undefined node `iframe_flag' in @ref (in ./Itensor.de.texi l. 1254
in mref)
*** Undefined node `vect_coords' in @ref (in ./Itensor.de.texi l. 1411
in mref)
*** Undefined node `iframe_flag' in @ref (in ./Itensor.de.texi l. 1467
in mref)
dieter at dieter:~/Maxima/maxima/doc/info/de$
At this time the definition of three nodes is missing. There are no more
problems in the German manual. Without the categories in the English
manual there are no problems too.
Dieter Kaiser