From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.comp.tex.context/15097 Path: main.gmane.org!not-for-mail From: =?iso-8859-1?q?Frank_K=FCster?= Newsgroups: gmane.linux.debian.devel.tetex,gmane.comp.tex.context,gmane.comp.tex.tetex.beta Subject: Bug#144647: manpages for some ConTeXt scripts Date: Sat, 08 May 2004 18:04:49 +0200 Message-ID: <878yg2rjku.fsf_-_@alhambra.bioz.unibas.ch> References: <408E99CB.7090501@net-b.de> <87d65oy0hx.fsf@alhambra.bioz.unibas.ch> <6.0.1.1.2.20040506100836.029faec0@server-1> Reply-To: =?iso-8859-1?q?Frank_K=FCster?= , 144647@bugs.debian.org NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Trace: sea.gmane.org 1084035312 17851 80.91.224.253 (8 May 2004 16:55:12 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 8 May 2004 16:55:12 +0000 (UTC) Cc: 144647@bugs.debian.org, tetex-pretest@dbs.uni-hannover.de Original-X-From: bounce-debian-tetex-maint=debian-tetex-maint=m.gmane.org@lists.debian.org Sat May 08 18:55:02 2004 Return-path: Original-Received: from murphy.debian.org ([146.82.138.6]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1BMV6M-00026b-00 for ; Sat, 08 May 2004 18:55:02 +0200 Original-Received: from localhost (localhost [127.0.0.1]) by murphy.debian.org (Postfix) with QMQP id C29AFED0D; Sat, 8 May 2004 11:54:45 -0500 (CDT) Old-Return-Path: Original-Received: from spohr.debian.org (spohr.debian.org [128.193.0.4]) by murphy.debian.org (Postfix) with ESMTP id 69328ECD1; Sat, 8 May 2004 11:54:40 -0500 (CDT) Original-Received: from debbugs by spohr.debian.org with local (Exim 3.35 1 (Debian)) id 1BMUzf-0000zz-00; Sat, 08 May 2004 09:48:07 -0700 X-Loop: owner@bugs.debian.org Resent-From: =?iso-8859-1?q?Frank_K=FCster?= Resent-To: debian-bugs-dist@lists.debian.org Resent-Cc: teTeX maintainers Resent-Date: Sat, 08 May 2004 16:48:07 UTC Resent-Message-ID: X-Debian-PR-Message: report 144647 X-Debian-PR-Package: tetex-bin X-Debian-PR-Keywords: Original-Received: via spool by 144647-submit@bugs.debian.org id=B144647.10840342912890 (code B ref 144647); Sat, 08 May 2004 16:48:07 UTC Original-Received: (at 144647) by bugs.debian.org; 8 May 2004 16:38:11 +0000 Original-Received: from balu1.urz.unibas.ch [131.152.1.51] by spohr.debian.org with esmtp (Exim 3.35 1 (Debian)) id 1BMUq3-0000kF-00; Sat, 08 May 2004 09:38:11 -0700 Original-Received: from alhambra.bioz.unibas.ch (bioz6-allgem17.bioz.unibas.ch [131.152.17.45]) by balu1.urz.unibas.ch (8.12.10/8.12.10) with ESMTP id i48Gc9Na012536; Sat, 8 May 2004 18:38:09 +0200 Original-Received: from localhost ([127.0.0.1] helo=alhambra.bioz.unibas.ch) by alhambra.bioz.unibas.ch with esmtp (Exim 3.35 #1 (Debian)) id 1BMUJl-0002kN-00; Sat, 08 May 2004 18:04:49 +0200 Original-To: ntg-context@ntg.nl In-Reply-To: <6.0.1.1.2.20040506100836.029faec0@server-1> (Hans Hagen's message of "Thu, 06 May 2004 10:21:54 +0200") User-Agent: Gnus/5.1002 (Gnus v5.10.2) Emacs/21.3 (gnu/linux) X-CrossAssassin-Score: 1 X-Mailing-List: archive/latest/7587 X-Loop: debian-tetex-maint@lists.debian.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Archive: Precedence: list Resent-Sender: debian-tetex-maint-request@lists.debian.org Xref: main.gmane.org gmane.linux.debian.devel.tetex:5321 gmane.comp.tex.context:15097 gmane.comp.tex.tetex.beta:241 X-Report-Spam: http://spam.gmane.org/gmane.comp.tex.context:15097 --=-=-= Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable Hi all, the Debian distribution tries to provide a manpage for every command in the patch, at least containing a pointer to the proper documentation. For some scripts in ConTeXt, these were missing. I have tried to write them. However, I don't use ConTeXt at all, therefore I would like to hear comments from real users. The suggested manpages are attached at the end. You can view them with "man -l filename". The fdf2tex manpage is meant to be used, via a symlink or alias, also for fdf2tan. However I don't really understand this...=20 Hans Hagen wrote: > Hi Frank, > > i cc this to the context list, just in case someone will volunteer for > helping you to get the man pages done It seems he forgot this - I will quote relevant parts of the mail. >> > texfind: A kind of grep with graphical output >> >>I just discovered this, this looks very interesting. Unfortunately I >>don't know much about perl, therefore I couldn't find out >> >>- whether it accepts any commandline options, besides "--font" for the >> menu font >> >>- how the search and replace stuff really works. I guess it also uses >> Perl regex syntax, and was able to do a replacement in the display >> window - but how can I save it to the file? > > you can't; it's mostly meant for users who cannot find back something, > say that i have this macro > > \itdoessomethingnice > > what one can do then is a recursive search and get an overview of > locations then; it's a rather stupid thing -) >=20 > it indeed accepts perl regexps > > someday i may extend it with some more options > But then the "replace" option doesn't make much sense, does it? Regards, Frank --=20 Frank K=FCster, Biozentrum der Univ. Basel Abt. Biophysikalische Chemie --=-=-= Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: attachment; filename=texfind.1 Content-Transfer-Encoding: quoted-printable .TH "texfind" "1" "April 2004" "ConTeXt" "teTeX"=20 .PP=20 .SH "NAME"=20 texfind \- graphical tool to search for text in TeX input files .PP=20 .SH "SYNOPSIS"=20 .PP=20 \fBtexfind\fP [ \fIOPTION\fP \&.\&.\&. ] .PP=20 .SH "DESCRIPTION"=20 .PP=20 \fBtexfind\fP is a graphical, interactive tool that helps you searching through TeX input files, including subdirectories, and allows you to do search/replace tasks using Perl regular expressions. It opens two windows: One displays the directory hierarchy and allows to select different search directories. The second window is used to enter the query and display the results. .PP .SH "SEARCHING" .PP Enter a search string in the input box at the top, choose the file extension (*tex by default) and hit ENTER to start the search. The results will be displayed below. .PP The search string is actually a perl regular expression. This gives you lots of flexibility. The search-and-replace function also uses Perl regex syntax, but you can also just use simple strings. Currently there is no way to save changed files. .PP=20 .SH "MENU"=20 .PP=20 Use the right mouse button to open a menu.=20 .HP \fBFile\fP : Currently only used to exit the program .HP \fBEdit\fP : Copy selections, select or unselect all .HP \fBSearch\fP : Open a \fBFind\fP dialog that allows further searching through the displayed results. The \fBReplace\fP option can be used to replace single or all occurrences of a string, but currently it is not possible to change the file. .PP \fBView\fP : Select specific lines, and adjust word or character wrapping.=20=20 .PP .SH "OPTIONS"=20 .HP \fB\-\-font\fR : specify the font used for the menu. Default is courier.=20 .HP Other options probably exist - I appreciate input by the program authors, experienced users or perl geeks. .HP .SH "SEE ALSO"=20 .IP=20 \fBperlre\fP(1) .PP=20 .SH "BUGS"=20 .PP=20 None known\&. Well - the replace function isn't the most useful one. .PP=20 .SH "AUTHOR"=20 .PP=20 \fBtexfind\fP was written for the ConTeXt package by Hans Hagen and Ton Otten, PRAGMA\&. .PP=20 This manual page was written by Frank K=FCster , for the Debian GNU/Linux system\&. It may be used and modified by others without contacting the author\&. Any mistakes or omissions in the manual page are my fault; inquiries about or corrections to this manual page should be directed to me (and not to the primary author)\&. --=-=-= Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: attachment; filename=texfont.1 Content-Transfer-Encoding: quoted-printable .TH TEXFONT "1" "May 2004" "teTeX " "texfont.pdf" .SH NAME texfont \- font installation tool for ConTeXt .PP .SH "SYNOPSIS"=20 \fBtexfont\fP [ \fIOPTION\fP \&.\&.\&. ] .PP=20 .SH DESCRIPTION .PP TeXFont is a perl script that helps to set up and install TeX fonts. It was designed for use with ConTeXt, but may also be helpful for users of other formats, like plain TeX or LaTeX. Its use is described in detail in the files mtexfont.pdf and mfont.pdf. .PP=20 .SH "OPTIONS"=20 .PP=20 .HP \fB\-\-fontroot\fR=3D\fIpath\fR : texmf font root (automatically determined) .HP \fB\-\-sourcepath\fR=3D\fIpath\fR : when installing, copy from this path (d= efault: .) .HP \fB\-\-sourcepath\fR=3D\fIauto\fR : locate and use vendor/collection .HP \fB\-\-vendor\fR=3D\fIname\fR : vendor name (first level directory) .HP \fB\-\-collection\fR=3D\fIname\fR : font collection (second level directory) .HP \fB\-\-encoding\fR=3D\fIname\fR : encoding vector (default: texnansi) .HP \fB\-\-slant\fR=3D\fIs\fR : slant glyphs in font by factor (0.0 - 1.5) .HP \fB\-\-extend\fR=3D\fIs\fR : extend glyphs in font by factor (0.0 - 1.5) .HP \fB\-\-caps\fR=3D\fIs\fR : capitalize lowercase chars by factor (0.5 - 1.0) .HP \fB\-\-noligs\fR : remove ligatures .HP \fB\-\-install\fR : copy files from source to font tree .HP \fB\-\-listing\fR : list files on auto sourcepath .HP \fB\-\-remove\fR : remove files on auto sourcepath .HP \fB\-\-makepath\fR : when needed, create the paths .HP \fB\-\-test\fR : use test paths for vendor/collection .HP \fB\-\-show\fR : run tex on texfont.tex .HP \fB\-\-batch\fR : process given batch file .HP \fB\-\-weight\fR : multiple master weight .HP \fB\-\-width\fR : multiple master width .HP \fB\-\-expert\fR : also handle expert fonts .HP \fB\-\-help\fR : show some more info .HP .SH "SEE ALSO"=20 .PP=20 \fBtexexec\fP(1), \fBfontinst\fP(1), \fBtexshow\fP(1), \fBtexutil\fP(1)\&. .PP=20 The TeXFont manual, \fImtexfont\&.pdf\fP\& .PP=20 The ConTeXt Font manual, \fImfonts\&.pdf\fP\& .PP The TeXExec manual, \fImtexexec\&.pdf\fP\&. .PP=20 Donald E\&. Knuth\'s \fIThe TeXbook\fP\&. .PP=20 .SH "AUTHOR"=20 .IP=20 This manual page was written by Frank K=FCster , for the Debian GNU/Linux system\&. It may be used and modified by others without contacting the author\&. Any mistakes or omissions in the manual page are my fault; inquiries about or corrections to this manual page should be directed to me (and not to the primary author)\&. .IP=20 The PDF manual and \fBtexfont\fP itself can be obtained from --=-=-= Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: attachment; filename=fdf2tex.1 Content-Transfer-Encoding: quoted-printable .TH FDF2TEX "1" "May 2004" "teTeX " "ConTeXt" .SH NAME fdf2tex \- Convert PDF formular data (FDF) into something (Con)TeX(t) can handle .PP .SH "SYNOPSIS"=20 \fBfdf2tex\fP \fIinfile\fP [ \fIoutfile\fP ] .PP \fBfdf2tan\fP \fIinfile\fP .PP=20 .SH DESCRIPTION .PP Converts PDF formular data (FDF) into something (Con)TeX(t) can handle. These commands are usually called indirectly during ConTeXt file processing. .HP .SH "BUGS" .PP Probably none - all errors are in this manpage .PP .SH "SEE ALSO"=20 .PP=20 \fBtexexec\fP(1)\&. .PP=20 The TeXExec manual, \fImtexexec\&.pdf\fP\&. .PP=20 .SH "AUTHOR"=20 .IP=20 This manual page was written by Frank K=FCster , for the Debian GNU/Linux system\&. It may be used and modified by others without contacting the author\&. --=-=-= Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: attachment; filename=ebb.1 Content-Transfer-Encoding: quoted-printable .TH "ebb" "1" "May 2004" "teTeX" "teTeX"=20 .PP=20 .SH "NAME"=20 ebb \- extract a bounding box from JPEG, PNG, and PDF files .PP=20 .SH "SYNOPSIS"=20 .PP=20 \fBebb\fP [ \fI -v\fP | \fI-b\fP ] \fI graphic_file\fP .PP=20 .SH "DESCRIPTION"=20 .PP=20 \fBebb\fP extracts the bounding box from JPEG, PNG, and PDF files (with lower- or uppercase extensions) and writes it into a file with the extension \fB.bb\fP, together with some header information. These files can then be used by \fBdvipdfm\fP or other programs. .PP .SH "OPTIONS"=20 .HP \fB\-v\fR : be verbose .HP \fB\-b\fR : Write .bb file in binary mode .HP .SH "BUGS"=20 .PP=20 I cannot find a difference between binary and standard .bb files\&. .PP=20 .SH "AUTHOR"=20 .PP=20 \fBebb\fP was written by Mark A. Wicks. .PP=20 This manual page was written by Frank K=FCster , for the Debian GNU/Linux system\&. It may be used and modified by others without contacting the author\&. Any mistakes or omissions in the manual page are my fault; inquiries about or corrections to this manual page should be directed to me (and not to the primary author)\&. --=-=-= Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: attachment; filename=makempy.1 Content-Transfer-Encoding: quoted-printable .TH makempy "1" "May 2004" "teTeX " "ConTeXt" .SH NAME makempy \- Helper script for conversion of (PDF or PostScript) text to \fBMetapost\fP graphics .PP .SH "SYNOPSIS"=20 \fBmakempy\fP \fIfilenam\fP .PP=20 .SH DESCRIPTION .PP \fBmakempy\fP takes \fBMetapost\fP output files (*\&.mpo) and translates them to *\&.mpy files. In order to include text as a graphic into a file typeset with (Con)TeX(t), you extract the text from Postscript of PDF files using \fBpdftops\fP and \fBpstoedit\fP, creating a Metapost input file. .PP This file can then be processed by \fBmakempy\fP. The \fBmakempy\fP script does its work without user intervention. When it deduces that there are no changes, it will not run at all, otherwise it will report its steps and/or encountered error. .SH "OPTIONS" .IP=20 .IP "\fB--help\fP"=20 returns some basic help information .IP=20 .IP "\fB--silent\fP"=20 don t report status messages .IP .IP "\fB--force\fP" always process the file (no checksum test) .IP .IP "\fB--noclean\fP" don t remove temporary files when finished .IP .IP "\fB--acrobat\fP" use ACROBAT for conversion (only unix) .IP .IP "\fB--pdftops\fP" use PDFTOPS for conversion .IP .IP "\fB--ghostscript\fP" use GHOSTSCRIPT for conversion .IP .SH "VARIABLES" .PP When set, the environment variables GS and GS_PROG will be used to identify GHOSTSCRIPT. If needed, the names of the other programs that are used can be set with PDFTOPS, ACROREAD and PSTOEDIT. .HP .SH "SEE ALSO"=20 .PP=20 \fBtexexec\fP(1)\&. .PP=20 The makempy manual, \fImmakempy\&.pdf\fP\&. .PP=20 .SH "AUTHOR"=20 .IP=20 This manual page was written by Frank K=FCster , for the Debian GNU/Linux system\&. It may be used and modified by others without contacting the author\&. --=-=-=--