Created manual page and info document for xorriso-tcltk

This commit is contained in:
Thomas Schmitt 2017-09-29 13:52:46 +02:00
parent f61d818d56
commit c3d302efe4
10 changed files with 422 additions and 5 deletions

View File

@ -237,12 +237,14 @@ nodist_pkgconfig_DATA = \
man_MANS = \ man_MANS = \
xorriso/xorriso.1 \ xorriso/xorriso.1 \
xorriso/xorrisofs.1 \ xorriso/xorrisofs.1 \
xorriso/xorrecord.1 xorriso/xorrecord.1 \
xorriso/xorriso-tcltk.1
info_TEXINFOS = \ info_TEXINFOS = \
xorriso/xorriso.texi \ xorriso/xorriso.texi \
xorriso/xorrisofs.texi \ xorriso/xorrisofs.texi \
xorriso/xorrecord.texi xorriso/xorrecord.texi \
xorriso/xorriso-tcltk.texi
# To have a file in releng_generated_data. If the directory itself is listed # To have a file in releng_generated_data. If the directory itself is listed
# in Makefile.am EXTRA_DIST, then its .svn subdir gets into the tarball. # in Makefile.am EXTRA_DIST, then its .svn subdir gets into the tarball.

View File

@ -12,6 +12,10 @@
# - receiving replies # - receiving replies
# - inquiring the xorriso message sieve # - inquiring the xorriso message sieve
# - using the xorriso parsing service # - using the xorriso parsing service
#
# It also may serve as educational frontend to xorriso which tells by
# its message window how to operate xorriso by commands and what it will
# reply.
# Note that any other language than Tcl/Tk could be used, if it only can # Note that any other language than Tcl/Tk could be used, if it only can
# do i/o via standard input and standard output or via named pipes. # do i/o via standard input and standard output or via named pipes.

View File

@ -7,9 +7,11 @@
( cd xorriso ; makeinfo ./xorriso.texi ) ( cd xorriso ; makeinfo ./xorriso.texi )
( cd xorriso ; makeinfo ./xorrisofs.texi ) ( cd xorriso ; makeinfo ./xorrisofs.texi )
( cd xorriso ; makeinfo ./xorrecord.texi ) ( cd xorriso ; makeinfo ./xorrecord.texi )
( cd xorriso ; makeinfo ./xorriso-tcltk.texi )
xorriso/make_xorriso_1 -auto xorriso/make_xorriso_1 -auto
xorriso/make_xorriso_1 -auto -xorrisofs xorriso/make_xorriso_1 -auto -xorrisofs
xorriso/make_xorriso_1 -auto -xorrecord xorriso/make_xorriso_1 -auto -xorrecord
xorriso/make_xorriso_1 -auto -xorriso-tcltk

View File

@ -6,6 +6,7 @@
Specialized converter from xorriso/xorriso.texi to xorriso/xorriso.1, Specialized converter from xorriso/xorriso.texi to xorriso/xorriso.1,
or from xorriso/xorrisofs.texi to xorriso/xorrisofs.1, or from xorriso/xorrisofs.texi to xorriso/xorrisofs.1,
or from xorriso/xorrecord.texi to xorriso/xorrecord.1. or from xorriso/xorrecord.texi to xorriso/xorrecord.1.
or from xorriso/xorriso-tcltk.texi to xorriso/xorriso-tcltk.1.
The conversion rules are described at the beginning of xorriso/xorriso.texi The conversion rules are described at the beginning of xorriso/xorriso.texi
@ -475,6 +476,7 @@ usage:;
fprintf(stderr, " -filter stdin -> stdout\n"); fprintf(stderr, " -filter stdin -> stdout\n");
fprintf(stderr, " -xorrisofs process xorriso/xorrisofs.texi\n"); fprintf(stderr, " -xorrisofs process xorriso/xorrisofs.texi\n");
fprintf(stderr, " -xorrecord process xorriso/xorrecord.texi\n"); fprintf(stderr, " -xorrecord process xorriso/xorrecord.texi\n");
fprintf(stderr, " -xorriso-tcltk process xorriso/-xorriso-tcltk.texi\n");
exit(2); exit(2);
} }
for(i= 1; i < argc; i++) { for(i= 1; i < argc; i++) {
@ -488,6 +490,9 @@ usage:;
} else if(strcmp(argv[i], "-xorrecord") == 0) { } else if(strcmp(argv[i], "-xorrecord") == 0) {
strcpy(name_in, "xorriso/xorrecord.texi"); strcpy(name_in, "xorriso/xorrecord.texi");
strcpy(name_out, "xorriso/xorrecord.1"); strcpy(name_out, "xorriso/xorrecord.1");
} else if(strcmp(argv[i], "-xorriso-tcltk") == 0) {
strcpy(name_in, "xorriso/xorriso-tcltk.texi");
strcpy(name_out, "xorriso/xorriso-tcltk.1");
} else { } else {
fprintf(stderr, "%s : unknown option %s\n", argv[0], argv[i]); fprintf(stderr, "%s : unknown option %s\n", argv[0], argv[i]);
goto usage; goto usage;

View File

@ -219,10 +219,13 @@ copy_files \
xorriso/xorrisofs.info \ xorriso/xorrisofs.info \
xorriso/xorrecord.texi \ xorriso/xorrecord.texi \
xorriso/xorrecord.info \ xorriso/xorrecord.info \
xorriso/xorriso-tcltk.texi \
xorriso/xorriso-tcltk.info \
xorriso/make_xorriso_1.c \ xorriso/make_xorriso_1.c \
xorriso/xorriso.1 \ xorriso/xorriso.1 \
xorriso/xorrisofs.1 \ xorriso/xorrisofs.1 \
xorriso/xorrecord.1 \ xorriso/xorrecord.1 \
xorriso/xorriso-tcltk.1 \
xorriso/man_1_xorriso.html \ xorriso/man_1_xorriso.html \
xorriso/man_1_xorrisofs.html \ xorriso/man_1_xorrisofs.html \
xorriso/man_1_xorrecord.html \ xorriso/man_1_xorrecord.html \

134
xorriso/xorriso-tcltk.1 Normal file
View File

@ -0,0 +1,134 @@
.\" Hey, EMACS: -*- nroff -*-
.\"
.\" IMPORTANT NOTE:
.\"
.\" The original of this file is kept in xorriso/xorriso-tcltk.texi
.\" This here was generated by program xorriso/make_xorriso_1
.\"
.\"
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH XORRISO-TCLTK 1 "Version 1.4.9, Sep 29, 2017"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.nh
.SH NAME
xorriso\-tcltk \- Educational GUI frontend for xorriso
.SH SYNOPSIS
.B xorriso-tcltk
[ options ]
.br
.SH DESCRIPTION
.PP
\fBxorriso\-tcltk\fR
demonstrates xorriso use cases by a collection of GUI components.
.br
.PP
It creates a window with buttons, editable text fields, and list boxes.
For exploration simply start
\fBxorriso\-tcltk\fR
without any options.
.br
.PP
Click on the "Help" button at the upper right edge to get an overview help
text in a separate window. It explains the three main parts of the GUI window
and it gives examples for a few main use cases of xorriso.
.br
.PP
Click by the rightmost mouse button on any button, list box, or text field,
to get a specific help text in another window.
.br
.PP
\fBxorriso\fR
is a program which copies file objects from POSIX compliant
filesystems into Rock Ridge enhanced ISO 9660 filesystems and performs
session\-wise manipulation of such filesystems. It can load the management
information of existing ISO images and it writes the session results to
optical media or to filesystem objects.
.br
Vice versa \fBxorriso\fR is able to copy file objects out of ISO 9660
filesystems.
.SS
.br
.SH OPTIONS
.br
.PP
Normally, no program options are needed when
\fBxorriso\-tcltk\fR
gets started. Some of the options are for demonstration of program development.
This man page lists only those options which may be helpful for end users.
.PP
.TP
\fB--help\fR
Print a help text with the complete list of start options and exit.
.TP
\fB--no_extract\fR
Do not allow extraction of files from ISO filesystem to
hard disk. This is not revokable during the program run.
.TP
\fB--geometry\fR {+|-}X{+|-}Y
Set the position of the main window on the screen. +0X is the left edge,
\-0X is the right edge, +0Y is the upper edge, \-0Y is the lower edge.
.TP
\fB--click_to_focus\fR
Chooses that input fields and list boxes get the keyboard
focus only when being clicked by the mouse. This is the default.
.TP
\fB--auto_focus\fR
Chooses that the keyboard focus is where the mouse pointer is.
.SH EXAMPLES
Just run
\fBxorriso\-tcltk\fR
in a shell terminal without any further arguments
.SH FILES
.SS
.B Startup files:
.br
When starting xorriso, its normal startup files get read and their text lines
get executed as commands. See section FILES in the man page of xorriso or
chapter Files in the info document of xorriso.
.SH SEE ALSO
.TP
.BR xorriso(1)
.SH BUGS
To report bugs, request help, or suggest enhancements for \fBxorriso\fR
or \fBxorriso\-tcltk\fR,
please send electronic mail to the public list <bug\-xorriso@gnu.org>.
If more privacy is desired, mail to <scdbackup@gmx.net>.
.br
Please describe what you expect the program to do,
the program arguments, GUI components, or dialog commands by which you
tried to achieve it,
the messages of \fBxorriso\fR, and the undesirable outcome of your
program run.
.br
Expect to get asked more questions before solutions can be proposed.
.SH AUTHOR
Thomas Schmitt <scdbackup@gmx.net>
.br
for libburnia\-project.org
.SH COPYRIGHT
Copyright (c) 2011 \- 2017 Thomas Schmitt
.br
Permission is granted to distribute this text freely. It shall only be
modified in sync with the technical properties of xorriso\-tcltk.
If you make use of the license to derive modified versions of xorriso\-tcltk
then you are entitled to modify this text under that same license.
.SH CREDITS
\fBxorriso\fR is in part based on work by Vreixo Formoso who provides
libisofs together with Mario Danic who also leads the libburnia team.
Thanks to Andy Polyakov who invented emulated growing,
to Derek Foreman and Ben Jansens who once founded libburn.
.br
Compliments towards Joerg Schilling whose cdrtools served me for ten years.

BIN
xorriso/xorriso-tcltk.info Normal file

Binary file not shown.

265
xorriso/xorriso-tcltk.texi Normal file
View File

@ -0,0 +1,265 @@
\input texinfo @c -*-texinfo-*-
@c %**start of header
@setfilename xorriso-tcltk.info
@settitle GNU xorriso-tcltk 1.4.9
@c %**end of header
@c
@c man-ignore-lines begin
@dircategory Archiving
@direntry
* Xorriso-tcltk: (xorriso-tcltk). Educational GUI frontend for xorriso
@end direntry
@c man-ignore-lines end
@c
@c Notes about embedded man page:
@c This texinfo code contains the necessary info to produce a man page
@c which resembles much the version of xorriso.1 from which this code
@c was originally derived in march 2010.
@c One can produce the man page by applying the following rules:
@c The first line gets discarded.
@c Line start "@c man " will become "", the remainder is put out unaltered.
@c Lines "@*" will be converted to ".br"
@c "@c man-ignore-lines N" will discard N following lines.
@c "@c man-ignore-lines begin" discards all following lines
@c up to "@c man-ignore-lines end".
@c Line blocks of "@menu" "@end menu" will be discarded.
@c "@item word words" becomes "\fBword\fR words".
@c @b{...}, @command{...}, @dfn{...}, @emph{...}, @strong{...}
@c get mapped to \fB...\fR .
@c @abbr{...}, @code{...}, @file{...}, @i{...}, @option{...}, @r{...},
@c @ref{...}, @samp{...},@var{...}, get mapped to ... .
@c @ref{...}, @xref{...} get mapped to empty text.
@c @email{...} gets mapped to <...> .
@c Mapped {...} content is subject to the rules except {...} mapping.
@c @minus{} will become "-".
@c @@ , @{, @} will get stripped of their first @.
@c Other lines which begin by "@" will be discarded.
@c In lines not stemming from "@c man", "\" becomes "\\"
@c "-" which are not preceded by an uneven number of "\" will get
@c prepended one "\".
@c
@c
@c man .\" Hey, EMACS: -*- nroff -*-
@c man .\"
@c man .\" IMPORTANT NOTE:
@c man .\"
@c man .\" The original of this file is kept in xorriso/xorriso-tcltk.texi
@c man .\" This here was generated by program xorriso/make_xorriso_1
@c man .\"
@c man .\"
@c man .\" First parameter, NAME, should be all caps
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
@c man .\" other parameters are allowed: see man(7), man(1)
@c man .TH XORRISO-TCLTK 1 "Version 1.4.9, Sep 29, 2017"
@c man .\" Please adjust this date whenever revising the manpage.
@c man .\"
@c man .\" Some roff macros, for reference:
@c man .\" .nh disable hyphenation
@c man .\" .hy enable hyphenation
@c man .\" .ad l left justify
@c man .\" .ad b justify to both left and right margins
@c man .\" .nf disable filling
@c man .\" .fi enable filling
@c man .\" .br insert line break
@c man .\" .sp <n> insert n+1 empty lines
@c man .\" for manpage-specific macros, see man(7)
@c man .nh
@c man-ignore-lines begin
@copying
xorriso-tcltk - Educational GUI frontend for xorriso
Copyright @copyright{} 2011 - 2017 Thomas Schmitt
@quotation
Permission is granted to distrubute this text freely.
@end quotation
@end copying
@c man-ignore-lines end
@titlepage
@title Manual of GNU xorriso frontend xorriso-tcltk 1.4.9
@author Thomas Schmitt
@page
@vskip 0pt plus 1filll
@insertcopying
@end titlepage
@contents
@ifnottex
@node Top
@top xorriso-tcltk 1.4.9
@c man-ignore-lines 1
@c man .SH NAME
xorriso-tcltk - Educational GUI frontend for xorriso
@end ifnottex
@menu
* Overview:: Overview
* Options:: Options
* Examples:: Examples
* Files:: Files
* Seealso:: See also
* Bugreport:: Reporting bugs
* Legal:: Author, Copyright, Credits
* CommandIdx:: Alphabetic Command List
* ConceptIdx:: Alphabetic List of Concepts and Objects
@end menu
@node Overview, Options, Top, Top
@chapter Overview
@c man .SH SYNOPSIS
@c man .B xorriso-tcltk
@c man [ options ]
@c man .br
@c man .SH DESCRIPTION
@c man .PP
@command{xorriso-tcltk}
demonstrates xorriso use cases by a collection of GUI components.
@*
@sp 1
@c man .PP
It creates a window with buttons, editable text fields, and list boxes.
For exploration simply start
@command{xorriso-tcltk}
without any options.
@*
@sp 1
@c man .PP
Click on the "Help" button at the upper right edge to get an overview help
text in a separate window. It explains the three main parts of the GUI window
and it gives examples for a few main use cases of xorriso.
@*
@sp 1
@c man .PP
Click by the rightmost mouse button on any button, list box, or text field,
to get a specific help text in another window.
@*
@sp 1
@c man .PP
@command{xorriso}
is a program which copies file objects from POSIX compliant
filesystems into Rock Ridge enhanced ISO 9660 filesystems and performs
session-wise manipulation of such filesystems. It can load the management
information of existing ISO images and it writes the session results to
optical media or to filesystem objects.
@*
Vice versa @command{xorriso} is able to copy file objects out of ISO 9660
filesystems.
@c man .SS
@node Options, Examples, Overview, Top
@chapter Options
@cindex xorriso, options
@c man .br
@c man .SH OPTIONS
@c man .br
@c man .PP
Normally, no program options are needed when
@command{xorriso-tcltk}
gets started. Some of the options are for demonstration of program development.
This man page lists only those options which may be helpful for end users.
@c man .PP
@c man .TP
@table @asis
@item @minus{}@minus{}help
@kindex @minus{}@minus{}help print help text to stderr
@cindex Help text, print to stderr, @minus{}@minus{}help
Print a help text with the complete list of start options and exit.
@c man .TP
@item @minus{}@minus{}no_extract
@kindex @minus{}@minus{}no_extract ban extraction of files to disk
@cindex Extraction of files, ban, @minus{}@minus{}no_extract
Do not allow extraction of files from ISO filesystem to
hard disk. This is not revokable during the program run.
@c man .TP
@item @minus{}@minus{}geometry @{+|-@}X@{+|-@}Y
@kindex @minus{}@minus{}geometry set position of main window
@cindex Main window, position, @minus{}@minus{}geometry
Set the position of the main window on the screen. +0X is the left edge,
-0X is the right edge, +0Y is the upper edge, -0Y is the lower edge.
@c man .TP
@item @minus{}@minus{}click_to_focus
@kindex @minus{}@minus{}click_to_focus click needed before text input
@cindex Keyboard focus, change by click, @minus{}@minus{}click_to_focus
Chooses that input fields and list boxes get the keyboard
focus only when being clicked by the mouse. This is the default.
@c man .TP
@item @minus{}@minus{}auto_focus
@kindex @minus{}@minus{}auto_focus text input where mouse is
@cindex Keyboard focus, where mouse is, @minus{}@minus{}auto_focus
Chooses that the keyboard focus is where the mouse pointer is.
@end table
@node Examples, Files, Options, Top
@chapter Examples
@c man .SH EXAMPLES
Just run
@command{xorriso-tcltk}
in a shell terminal without any further arguments
@c man .SH FILES
@node Files, Seealso, Examples, Top
@chapter Files
@c man .SS
@c man .B Startup files:
@section Startup Files
@*
When starting xorriso, its normal startup files get read and their text lines
get executed as commands. See section FILES in the man page of xorriso or
chapter Files in the info document of xorriso.
@c man .SH SEE ALSO
@c man .TP
@c man .BR xorriso(1)
@c man-ignore-lines begin
@node Seealso, Bugreport, Files, Top
@chapter See also
info xorriso
@c man-ignore-lines end
@c man .SH BUGS
@node Bugreport, Legal, Seealso, Top
@chapter Reporting bugs
@cindex Bugs, reporting
@cindex Problems, reporting
To report bugs, request help, or suggest enhancements for @command{xorriso}
or @command{xorriso-tcltk},
please send electronic mail to the public list @email{bug-xorriso@@gnu.org}.
If more privacy is desired, mail to @email{scdbackup@@gmx.net}.
@*
@sp 1
Please describe what you expect the program to do,
the program arguments, GUI components, or dialog commands by which you
tried to achieve it,
the messages of @command{xorriso}, and the undesirable outcome of your
program run.
@*
@sp 1
Expect to get asked more questions before solutions can be proposed.
@c man .SH AUTHOR
@node Legal, CommandIdx, Bugreport, Top
@chapter Author, Copyright, Credits
@section Author
Thomas Schmitt <scdbackup@@gmx.net>
@*
for libburnia-project.org
@c man .SH COPYRIGHT
@section Copyright
Copyright (c) 2011 - 2017 Thomas Schmitt
@*
Permission is granted to distribute this text freely. It shall only be
modified in sync with the technical properties of xorriso-tcltk.
If you make use of the license to derive modified versions of xorriso-tcltk
then you are entitled to modify this text under that same license.
@c man .SH CREDITS
@section Credits
@command{xorriso} is in part based on work by Vreixo Formoso who provides
libisofs together with Mario Danic who also leads the libburnia team.
Thanks to Andy Polyakov who invented emulated growing,
to Derek Foreman and Ben Jansens who once founded libburn.
@*
Compliments towards Joerg Schilling whose cdrtools served me for ten years.
@c man-ignore-lines begin
@node CommandIdx, ConceptIdx, Legal, Top
@chapter Alphabetic Options List
@printindex ky
@node ConceptIdx,, CommandIdx, Top
@chapter Alphabetic List of Concepts and Objects
@printindex cp
@c man-ignore-lines end
@bye

View File

@ -314,12 +314,14 @@ indent: $(indent_files)
man_MANS = \ man_MANS = \
xorriso/xorriso.1 \ xorriso/xorriso.1 \
xorriso/xorrisofs.1 \ xorriso/xorrisofs.1 \
xorriso/xorrecord.1 xorriso/xorrecord.1 \
xorriso/xorriso-tcltk.1
info_TEXINFOS = \ info_TEXINFOS = \
xorriso/xorriso.texi \ xorriso/xorriso.texi \
xorriso/xorrisofs.texi \ xorriso/xorrisofs.texi \
xorriso/xorrecord.texi xorriso/xorrecord.texi \
xorriso/xorriso-tcltk.texi
EXTRA_DIST = \ EXTRA_DIST = \
xorriso.pc.in \ xorriso.pc.in \

View File

@ -1 +1 @@
#define Xorriso_timestamP "2017.09.23.074650" #define Xorriso_timestamP "2017.09.29.113942"