Menu

#3826 `make html` destroyed

obsolete: 8.5b2
closed-fixed
9
2007-10-31
2007-10-26
Don Porter
No

The `make html` target is completely
hosed, thanks to new macros and
formatting directives in the
doc/*.3 and doc/*.n files that
tools/tcltk-man2html.tcl has no
clue how to process.

The Tcl/Tk 8.5b2 releases will
have no HTML documentation because
of this.

Discussion

  • Don Porter

    Don Porter - 2007-10-26

    Logged In: YES
    user_id=80530
    Originator: YES

    Recent doc changes reverted
    as a workaround. They're welcome
    to be restored, once the tools
    to deal with them are ready to use.

     
  • Donal K. Fellows

    Logged In: YES
    user_id=79902
    Originator: NO

    'make html' works now with the versions you backed out in Tcl at least. Check back in (I don't see why I should do it!) do a rerun if 'make html' and let me know if there are any problems with a full build. (If there are, they're probably doc formatting bugs that need to be fixed anyway.)

     
  • Donal K. Fellows

    • assigned_to: dkf --> dgp
     
  • Donal K. Fellows

    • assigned_to: dgp --> dkf
    • status: open --> closed-fixed
     
  • Donal K. Fellows

    Logged In: YES
    user_id=79902
    Originator: NO

    On second thoughts, don't. There are now too many changes by others in the way.

    Crap.

     
  • Don Porter

    Don Porter - 2007-10-30

    Logged In: YES
    user_id=80530
    Originator: YES

    confirmed that `make html`
    is in much better shape
    on the HEAD now. Just a few
    warnings left to address:

    scanning page /home/dgp/cvs/tcl/unix/../../tcl8.5b2/doc/expr.n
    expr: unrecognized format directive: .ni
    expr: COPYRIGHT: ignoring .fi

    scanning page /home/dgp/cvs/tcl/unix/../../tcl8.5b2/doc/mathfunc.n
    mathfunc: process-text: uncaught backslash: Returns the arc tangent of <I>y</I>/<I>x</I>, in the range [<I>-pi</I>,<I>pi</I>]
    radians. <I>x</I> and <I>y</I> cannot both be 0. If <I>x</I> is greater
    than <I>0</I>, this is equivalent to
    &#8220;<B>atan </B>[<B>expr</B> {<I>y</I><B>/</B><I>x</I>}]\fR&#8221;.

     
  • Don Porter

    Don Porter - 2007-10-30
    • status: closed-fixed --> open-fixed
     
  • Donal K. Fellows

    Logged In: YES
    user_id=79902
    Originator: NO

    already squelched them

    (Right now, 'make html' is clean and the output looks good...)

     
  • Donal K. Fellows

    • status: open-fixed --> closed-fixed