<div dir="ltr">Typically you pick a verb (like psfile) which starts the special; most drivers look for and<div>support specific verbs.  As long as you pick a unique verb you should be okay.</div><div><br></div><div>Dvips has a long and perhaps tortured history with specials.  It recognizes the following</div><div>prefixes.  The ones with colons require the colons.  The ones with = signs generally</div><div>require an equals sign.</div><div><br></div><div>landscape<br></div><div>papersize</div><div>header</div><div>xtex:</div><div>background</div><div>color</div><div>"</div><div>!</div><div>em:</div><div>ps:</div><div>psfile=</div><div>ifffile=</div><div>tekfile=</div><div>hsize=</div><div>vsize=</div><div>hoffset=</div><div>voffset=</div><div>hscale=</div><div>vscale=</div><div>angle=</div><div>llx=</div><div>lly=</div><div>urx=</div><div>ury=</div><div>rwi=</div><div>rhi=</div><div>clip=</div><div><br></div><div>If TPIC is compiled in, the following additional keywords are recognized:</div><div><br></div><div>pn pa fp ip da dt sp ar ia sh wh bk tx</div><div><br></div><div>These all require an immediate space afterwards, or that they have no</div><div>following characters.</div><div><br></div><div>My recommendation is to pick a reasonably verbose prefix such as</div><div>hypertex: or something.  Right now there's no special "registry" that I am</div><div>aware of, whether formal or informal, but if you ask on texhax if that</div><div>prefix is used, I think most maintainers can tell you.</div><div><br></div><div>I don't recommend examining the "dospecial.c" code of dvips unless</div><div>you have a ready and copious supply of eyewash.  I know that I will</div><div>be trying hard this evening to unsee some of the things I just saw.</div><div><br></div><div>-tom</div><div><br></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Fri, Feb 26, 2016 at 4:58 PM, Douglas McKenna <span dir="ltr"><<a href="mailto:doug@mathemaesthetics.com" target="_blank">doug@mathemaesthetics.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">\special{} commands insert arbitrary text strings into a box's contents.  The strings are exported along with the box and its contents by the interpreter to whatever's on the back end willing to respond to the information (DVI tools, XDVI tools, PDF tools, in my case a custom eBook reader program linked to my own TeX interpreter library, etc.).<br>
<br>
I'm assuming that the rule is that any backend that doesn't recognize a particular \special{} exported its way simply ignores it.  So far so good.<br>
<br>
I would like to implement some \specials{} so as to deliver to my backend (client program) information I place inside a box, using macro commands defined in the TeX source code.<br>
<br>
Is there an informal syntax or agreed-upon formatting standard in the TeX community for ensuring that a custom \special{} extension such as this doesn't conflict with or confuse an existing \special{} being used in some package, format, or other part of the greater TeX ecosystem?<br>
<br>
How does one determine the currently supported set of implemented \special{} commands that everyone in the TeX world depends upon, so I can avoid creating a conflict?<br>
<br>
How are such conflicts resolved?<br>
<br>
IMWTK!<br>
<br>
<br>
Doug McKenna<br>
<br>
<br>
_______________________________________________<br>
TeX FAQ: <a href="http://www.tex.ac.uk/faq" rel="noreferrer" target="_blank">http://www.tex.ac.uk/faq</a><br>
Mailing list archives: <a href="http://tug.org/pipermail/texhax/" rel="noreferrer" target="_blank">http://tug.org/pipermail/texhax/</a><br>
More links: <a href="http://tug.org/begin.html" rel="noreferrer" target="_blank">http://tug.org/begin.html</a><br>
<br>
Automated subscription management: <a href="http://tug.org/mailman/listinfo/texhax" rel="noreferrer" target="_blank">http://tug.org/mailman/listinfo/texhax</a><br>
Human mailing list managers: <a href="mailto:postmaster@tug.org">postmaster@tug.org</a><br>
</blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div>--  <a href="http://cube20.org/" target="_blank">http://cube20.org/</a>  --  <a href="http://golly.sf.net/" target="_blank">[</a>Golly link suppressed; ask me why]  --</div></div></div>
</div>