Tk Source Code

View Ticket
Login
Ticket UUID: a84de1a4d38c21d220cf121c4d3ba5578fff7561
Title: Documentation errors
Type: Bug Version: trunk
Submitter: dgp Created on: 2024-04-29 19:43:37
Subsystem: 84. Unix Build Assigned To: dkf
Priority: 5 Medium Severity: Minor
Status: Closed Last Modified: 2024-04-30 12:27:35
Resolution: Fixed Closed By: jan.nijtmans
    Closed on: 2024-04-30 12:27:35
Description:
When making a source code distribution, the `make html` target
is intended to generate HTML versions of the man pages.  As
part of the processing, some syntax checking is done and messages
about problems are displayed.  Current trunk of Tk apparently has
some problems:

loadTk: process-text: impotent font change: The <b>safe::loadTk</b> command initializes the required data structures in
the named safe interpreter and then loads Tk into it.  The interpreter must
have been created with <b>safe::interpCreate</b> or have been initialized
with <b>safe::interpInit</b>.  The command returns the name of the safe
interpreter.  If <b>-use</b> is specified, the window identified by the
specified system dependent identifier <i>windowId</i> is used to contain the
&ldquo;.&rdquo;
window of the safe interpreter; it can be any valid id, eventually referencing
a window belonging to another application. As a convenience, if the window you
plan to use is a Tk Window of the application you can use the window name
(e.g.,
&ldquo;<b>.x.y</b>&rdquo;)
instead of its window Id (e.g., from \fBwinfo id\fB .x.y\fR).
When \fB-use\fR is not specified, a new toplevel window is created for the
&ldquo;.&rdquo;
window of the safe interpreter. On X11 if you want the embedded window to use
another display than the default one, specify it with \fB-display\fR.  See
the \fBSECURITY ISSUES\fR section below for implementation details.
............
unbalanced .RS .RE
photo: FORMAT SUBOPTIONS: output-directive: unexpected .RE
............systray: process-text: impotent font change: \fBtk systray create \fB-image \fIimage\fR ?\fB-text \fItext\fR? ?\fB-button1 \fIcallback\fR? ?\fB-button3 \fIcallback\fR?
\fBtk systray configure \fI?option? ?value option value ...?\fR
\fBtk systray exists\fR
\fBtk systray destroy\fR
...
tk_mac: make-manpage-section: ignoring .SH "ADDITIONAL DIALOGS" after .TP

tk_mac: make-manpage-section: ignoring .PP after .TP



scanning section Tk C API, version 9.0b2
..................CrtPhImgFmt: SYNOPSIS: output-directive: ignoring .fi
User Comments: jan.nijtmans added on 2024-04-30 12:27:35:

Many thanks, Harold!

Last fix [1eb1db5ce78cd33c|here]

Closing.


oehhar added on 2024-04-30 08:37:57:

Fixed all issues, expect the following one:

CrtPhImgFmt: SYNOPSIS: output-directive: ignoring .fi

I did not find the text "CrtPhImgFmt" in any doc folder.

Take care, Harald


jan.nijtmans added on 2024-04-30 08:32:10:

It looks like [3766abef1f37ad35|this] commit introduced the 'problems'. Assigning to dkf