[tex-eplain] btxmac.tex causes Runaway definition and Forbiddencontrol sequence on compile.

[Laurence.Finston at gmx.net]

> Links already worked, but this turns the borders black instead of blue, which shows that changes are being applied to the driver.

I'm not sure what you mean by this.  The option `dvipdfm' is only for use when using dvipdfm or dvipdfmx.  I'm not sure whether it works with dvips and then ps2pdf.  I would guess not.  I usually use dvipdfmx (to create PDFs) and occasionally dvips to create PostScript files.  I get the impression that more people are using pdftex than dvips, etc., nowadays.  I sometimes use pdftex, in which case the `pdftex' option must be used.

> > \hlstart{}{bwidth=0}{instructions}\Blue{General Instructions}\hlend
> > [...]
> > \hldest{fit}{}{instructions}
>

> What are these commands for (besides color), where do I put them, and what code do they need from me (where you have "General Instructons", "[...]"and "instructions")?

\hlstart ... \hlend create the link.  \Blue is a macro from the the dvips package and only works when you're using dvips, dvipdf, dvipdfmx or some other program from the dvips package, if there are any.  If you want to use it, and the other color commands, you need to include `colordvi.tex' (/usr/share/texlive/texmf-dist/tex/generic/dvips/colordvi.tex on my system)
or, equivalently, `colordvi.sty'.  If you're using pdftex or some other version of TeX (or a non-conforming TeX-like program) to produce PS or PDF, or some other program for converting DVI to PS or PDF or some other format, this will not apply.  \hldest goes where you want the link to point, i.e., where you're supposed to jump to when you click the link.  It might be in the same document or somewhere else.  "General Instructions" is the text of link, printed in blue.  "instructions" is the identifier for the link.  "fit" determines the behavior when you click on the link, i.e., how page is displayed in the browser or PDF viewer.  That's all I remember off the top of my head, so for more details, please see the eplain manual.

These are the commands when using dvips:

tex myfile.tex
dvips -o myfile.ps myfile.dvi

To convert to PDF:
pstopdf myfile.ps

or to produce PDF directly from DVI:

tex myfile.tex
dvipdfmx myfile.dvi

> Gesendet: Mittwoch, 11. Oktober 2023 um 08:57 Uhr
> Von: terry.s at Safe-mail.net
> An: Laurence.Finston at gmx.net
> Betreff: Re: [tex-eplain] btxmac.tex causes Runaway definition and Forbiddencontrol sequence on compile.
>
> Hi Laurence,
>
> > \enablehyperlinks[dvipdfm]
>
> Links already worked, but this turns the borders black instead of blue, which shows that changes are being applied to the driver.
>
> > I often add this: \hlopts{bwidth=0}
> Thank you, \hlopts{bwidth=0} gets rid of the ugly circle around the parentheses (and all link borders in general).
>
> > \hlstart{}{bwidth=0}{instructions}\Blue{General Instructions}\hlend
> > [...]
> > \hldest{fit}{}{instructions}
>
> What are these commands for (besides color), where do I put them, and what code do they need from me (where you have "General Instructons", "[...]"and "instructions")?
>