; TeX output 1998.01.17:2005y?DtGGcmr17The7tGGcmss17shoqwkeyspackage!", cmsy10XQ cmr12DarvidCarlisle37 1997/06/12:ōRNff cmbx121jLIntros3duction ff1S  ffߤN cmtt9sec:intro0F ffffff1S R'ExXbGoxofzerowidth,XwhichmaypGossiblyover-printothertext.yThe\ref,R\pagerefͲand\citecommandsprinttheirargumentsinsmalltypGe,raisedjustRabGove theline,likethis:)# cff Cscmtt8sec:introfe&@$)#1.AZThispackqageworkswiththe!m#R cmss10 eqnoption,thepackqagesRinUUtheAMS-L5ffٓRcmr7A͉TU>'ExXcollection,andthevarioref,UUnatbibandharvardUUpackqages.!čR2jLPackageffOptions 獍 ff'  ffoptions' ffffff'掎 34RSomepGeoplehavecommentedthattheprintingofthe\refand\citekeysislessRuseful=Bthantheprintingofthe\labelkeysandsoshowkeysnowsuppGortstwoRoptionsUUthatcanbGegiveninthe\usepackagecommand:R""V cmbx10notrefu!to'stoptherede nitionof\refand\pageref,[andrelatedcommandskfromUUthevariorefpackqage.Rnotciteyزtosstoptherede nitionof\citeandrelatedcommandsfromtheharvardkandUUnatbibpackqages.RSoifthepackqageisloadedwith\usepackage[notref]{showkeys}then\refwillRhaveitsstandardde nition,A&but\labelwillprintitskeyargument(usuallyinRtheUUmargin).aIf you ndtheprintedkeysdistracting,Nbutdon'twanttousetheabGoveoptionsRtoUUstopthemaltogetheryoumayuse:RcoloroPrintUUthekeysinadistinguishingcolour.qThedefaultvqalueisalightgrey*.RX-ffr @ -:q% cmsy6L|{Ycmr8ThisX lehasvÎersionnumbie>ie>ie>ie>ie>ie>ie>ie< ie>ie>ie>ie>ie>ie>ie>ie>ie:َ:LWithinDenvironmentslikethisminipage,wecan-Lnotuse\marginpar^1|s,HsotheappGearanceisslightlyLdi erent. &Here<isthatenumerateenvironmentLagain::ffl  ffm&e^1 fffffflDžز1.LThisUUhas\labelimmediatelyafter\item.Dž2.LThisUUhasthe\labelattheend.:ffl  ffm&e^2 ffffffl9aDisplayedUUmath(withoutequationcounter).{X0=0ff$  ffdispX ffffff$aSomeUUtextreferingtothemathsonpage cffdispfe2,andtheitem cffe^1fe 1. aIfshowkeysthinksthatthecurrentenvironmentisgoingtoproGducean\equa-RtionnumbGer",thenitdoesnotshowthelabelwherethe\labelcommandoccurs,R^ffr J= "5-:Aacmr61LActually\marginparXisnotusedatallinthispacÎkagenow.2 y?RbutPJtriestoputitinthemargin,QLasshownwithequation ffeq:xxfe@1.pThepackqage`knows' RabGoutTthestandardequationandeqnarrayenvironments,THandTalsoallthenum-RbGeredUUalignmentenvironmentso eredbytheAMSL5ffA͉TU>'ExXpackqage,amsmath.X1=18(1) ffl ffeq:xx ffffffli۟p2q=c28(2) ff' ffeqnar:a' ffffff'掎p3q=c3p4q=c48(3) ff'  ffeqnar:b' ffffff'掎7l9RWithin afigureenvironment,7Rthe \labelmustnotcomebGeforethe\caption Rcommand.h\If9youplace\labelinsidetheargumentof\captionthelabGelwillbeRshownUUlikethis: FigureUU1:qWithinthecaptionargument. ffl ffcap:a fffffflRIfyouplace\labelimmediatelyafterthe\captioncommanditwillbGeshownRlikeUUthis:jFigureUU2:qImmediatelyafterthecaptionargument.ffl  ffcap:b fffffflRIfyouplacethe\labelcommandatsomerandompGointafterthe\captionRcommand,UUitmaybGeshownlike:qFigureUU3:qInverticalmoGdenotimmediatelyafterabox. Ǎ(F ffl ffcap:c ffffffl*RReferences(Fffl  ffGN:sl fffffflR[1]a;GiltNeiger,#': cmti10showlab}'els.sty,Undatedpackqage,similartothisone,butshows a;labGelsUUinline,a ectingtheformatingofthedocument.荍 ff'  ffanon:sk' ffffff'掎R[2]a;Annonymous,[rshowkeys.sty,Packqage,datedZ914May1988.V*erysimilartothisa;one,UUalsouses\marginparinouterverticalmoGde.#ٰff#&P  ffDMJ:mi"Y ffffff#&PR[3]a;DavidM.Jones,&TKß'E-XߵMacr}'oIndex,AcatalogueofTU>'ExXmacros,includinga;L5ffA͉TU>'ExXUUpackqages,avqailablefromallgoGodUUTU>'ExXarchives. 欍R4jLTheffMacrosUs1\% cmsy9h&ow cmss9pack9age#g i獑aFirstwehandletheoptions.NNormallyallrelatedcomandsarede nedtoshowRtheirUU`keys'.qButsincev3.03onecanspGecify:anotref$tostoptherede nitionof\ref(and\pageref,andrelatedcommandsRfromUUvariorefpackqage),3y?anotcitetostoptherede nitionof\citeandrelatedcommandsfromthe RharvardUUandnatbibpackqages. Us2\\DeclareOption{notref}{\let\SK@ref\@empty}Us3\\DeclareOption{notcite}{\let\SK@cite\@empty}5b\SK@refcolor 6\SK@labelcolorRColourUUcommands.qNormallyno-op. aUs4\\let\SK@refcolor\relaxUs5\\let\SK@labelcolor\relax#Oacoloroptionloadsthecolorɤpackqageandde nesthecolours.d DelayedtotheRendUUofthepackqageaspackqageloadingnotallowedinthisoptionsection. aUs6\\DeclareOption{color}{\AtEndOfPackage{%Us7f\RequirePackage{color}%Us8f\definecolor{refkey}{gray}{.75}%Us9f\definecolor{labelkey}{gray}{.75}%R10f\def\SK@refcolor{\color{refkey}}%R11f\def\SK@labelcolor{\color{labelkey}}}}aaAllowNfinaltobGespeci edinthedocumentclassoptionstosupresstheloadingRofUUthispackqage. aR12\\DeclareOption{final}{\endinput}R13\\DeclareOption{draft}{}5R14\\ProcessOptions#O$\SK@labelL\SK@bibitemb\SK@lbibitemRTheUUsavedoriginalde nitions aR15\\let\SK@label\labelR16\\let\SK@bibitem\@bibitemR17\\let\SK@lbibitem\@lbibitem#O+\labelRTheUUnewde nition,printtheargument,andthendotheoldde nition.R18\\def\label#1{%R19f\@bsphackR20f\SK@\SK@@label{#1}%R21f\begingroupR22o\SK@label{#1}%R23f\endgroupR24f\@esphack}#O$\@bibitem \@lbibitemRF*or*\bibitem,pGositiontheshowkeys*codeasforastandardlistwith\itemand R\label.R25\\def\@bibitem#1{%R26f\SK@bibitem{#1}\SK@\SK@@label{#1}\ignorespaces}5R27\\def\@lbibitem[#1]#2{%R28f\SK@lbibitem[#1]{#2}\SK@\SK@@label{#2}\ignorespaces}#O5`\SK@RGrab&holdof#2via\meaningsocharacterslike&and^donotcauseproblems Rlater,UUandpasstheresultontothecommand#1.R29\\def\SK@#1#2{%R30f\protected@edef\@tempa{#2}%R31f\expandafter#1\meaning\@tempa\SK@}4'Vy?\SK@@labelRStripFbo theinitialsegmentofthe\meaningoutput,I`andthenputtheresteither Rin1Ba\marginparorinabGoxofsize0pt,8yhopefullynotdisturbingthesurroundingRtext. UR32\\def\SK@@label#1>#2\SK@{%URNeedtoworkgloballyasinsomecaseslikealignments,andfleqn,thecounterRwillUUbGeprintedinadi erentgrouptothe\labelcommand.R33f\gdef\SK@lab{\smash{\SK@labelcolor\fbox{% R34\normalfont\small\ttfamily#2}}}%R35f\ifvmodeR36o\if@inlabelURIfthe\labelisstraightafter\item(\bibitemishandledbythiscaseaswell) RthenitheitemlabGelhasnotbeenaddedtothepageyet.MItishangingaroundinRtheObGox\@labelswaitingfortheparagraphtostart.pSojustneedtoattatchtheRlabGelUUtothisbox.R37y2\global\setbox\@labels\hbox{% R38w^\llap{\SK@lab\SK@lab@relaxR39\kern\@totalleftmargin\kern\marginparsep}%R40w^\box\@labels}%R41o\elseRIf'weinsertabGoxintothemainverticallist,donotwanttochange\prevdepth RasmthatwouldafectverticalspacinginthedoGcument.,(ThebGoxitselfshouldnotRcause?{anydi erenceinbreakpGointsasthereisanoGdethereanywaycomingfromRtheUU\writetotheaux le.R42y2\dimen@\prevdepth R43y2\nointerlineskipURTheinnerverticalmoGdecasesaremainlydesignedtodotherightthingwith oatRcaptions,UUbutseemtoworkOKinothercasesaswell.R44y2\ifinner R45w^\skip@\lastskip\unskipURIn7RinnerverticalmoGde,=RattachthelabGeltotherightoftheimmediatelyprecedingRbGox,]if[itisaboxbeforethecurrentpoint.OtherwisejustputitinaboxofzeroRdimensions,fwithbnointerlineskip.(ThismayslightlymovethesurroundingtextR(butUUpGerhapsnotnowthat\prevdepthisrestored.)R46w^\advance\skip@\lastskip\unskip R47w^\setbox\z@\lastboxR48w^\ifvoid\z@R49\llap{\SK@lab\SK@lab@relax\kern\marginparsep}%R50w^\elseR51\hbox{\box\z@\kern\marginparsep\SK@labx}%R52w^\fiR53w^\vskip\skip@R54y2\elseRInIzouterverticalmoGde,Kpreviouslyuseda\vadjustatthestartofthenextpara- Rgraph#(andbGeforethatused\marginpar).aEThesemethodssometimescauseextra51Ey?Rspace,"Pegifparagraphstartswithamathdisplay*,sonowjustinsertthebGox Rdirectly*,UUtakingcarenottochange\prevdepth. 3R55w^\llap{\SK@lab\SK@lab@relax\kern\marginparsep}% R56y2\fi3RRestoreUU\prevdepth.R57y2\prevdepth\dimen@fR58o\fiR59f\elsefRIfweareinannumbGeredequation-styleenvironment,donothingasthecoGdeto RprintHthenumbGerwillalsoprintthelabGel,otherwisejuststickthelabGelattheRcurrentUUpGoint,inabGoxofzerodimensions. 3R60o\csnameSK@\@currenvir\endcsnameR61o\ifSK@equation\elseR62y2\ifmmodeR63w^\SK@labxR64y2\else3RInnerUUhorizontalmoGde.qNotmuchwecando,juststickithere.R65w^\ifinnerR66\rlap\SK@labR67y2\else3RInUUouterhorizontalmoGdeuse\vadjusttogettothemargin.R68\vadjust{\llap{\SK@lab\kern\marginparsep}}%R69w^\fiR70w^\SK@lab@relaxR71y2\fiR72o\fiR73f\fi}ٚb\iftagsleft@RMakeUUsurethatthisAMSL5ffA͉TU>'ExXcommandreallyisan\if..R74\\AtBeginDocument{%R75f\let\SK@eqnnum\@eqnnumR76f\def\@tempa{\let\iftagsleft@\iffalse}%R77f\ifx\iftagsleft@\undefined\@tempa\fi%ٚ\tag@form@ '3P\eqnnumRPerhaps}ifleqnoisopGerative,I]shouldde ne\@eqnnumwiththe`left'version,but RitUUdoGesnotreallymatter.R78f\let\SK@tagform@\tagform@R79f\iftagsleft@R80o\def\tagform@#1{%R81y2\ifx\df@label\@emptyR82w^\SK@lab@relaxR83y2\elseR84w^\expandafter\SK@@label\meaning\df@label\SK@R85y2\fiR86y2\llap{\SK@lab\kern\marginparsep}%R87y2\SK@lab@relax\SK@tagform@{#1}}%6<y?R88o\def\@eqnnum{% R89y2\llap{\SK@lab\kern\displaywidth\kern\marginparsep}%R90y2\SK@lab@relax\SK@eqnnum}%R91f\elseR92o\def\tagform@#1{%R93y2\ifx\df@label\@emptyR94w^\SK@lab@relaxR95y2\elseR96w^\expandafter\SK@@label\meaning\df@label\SK@R97y2\fiR98y2\SK@tagform@{#1}%R99y2\rlap{\kern\marginparsep\SK@lab}\SK@lab@relax}%N100o\def\@eqnnum{\SK@eqnnum\rlap{\kern\marginparsep\SK@lab}%N101\SK@lab@relax}%N102f\fi}"y\SK@labxRPrintUUthelabGel,andthengloballyresettheprintcommandto\relax.N103\\def\SK@labx{\rlap\SK@lab\global\let\SK@lab\relax} \SK@lab@relaxRClearUUthelabGel.N104\\def\SK@lab@relax{\global\let\SK@lab\relax}\SK@lab@relaxb\SK@equation b\SK@eqnarrayRThekfollowingenvironmentsprintanequationnumbGer,so\labelshouldnotprint RitsargumentatthepGointwhereitappGears. NotethiswillfailtoshowthelabGelRif)youareinaneqnarrayenvironment,2anduse\labeltogetherwith\nonumberRThisՐmightjustabGoutmakesenseifyouaregoingtouse\pageref,butthatisRtoGoUUbad...N105\\newif\ifSK@equation N106\\let\SK@equation\SK@equationtrueN107\\let\SK@eqnarray\SK@equationtrue$\eqnarrayRWhenWtheAMS>packqagesareloadedshowkeysassumesenvironmentswork`The RAMSKway'`Howevereqnarray(unlikeequation)isnotrede ned,^sohereweneedRtoUUremovesomeoftheAMShacks.N108\\toks@\expandafter{\eqnarray} N109\\edef\eqnarray{\let\noexpand\tagform@\noexpand\SK@tagform@\the\toks@}$\SK@alignL\SK@alignatb\SK@xalignat \SK@xxalignat\SK@gatherb\SK@multlineL\SK@flalignRTheUUAMSenvironmentsN110\\let\SK@align\SK@equationtrue N111\\let\SK@alignat\SK@equationtrueN112\\let\SK@xalignat\SK@equationtrueN113\\let\SK@xxalignat\SK@equationtrueN114\\let\SK@gather\SK@equationtrueN115\\let\SK@multline\SK@equationtrueN116\\let\SK@flalign\SK@equationtrue7E,y?'3P\SK@defRThissmacrorede nesacommand#1.Thenewde nitioncanmakeuseofthe RoldXde nitionas\SK@old2name."If#1isreallya\protect'edcommandwiththeRreal&Dde nitionina`sp}'ace['&Dcommandthenthe`space'versionisusedastheoldRde nition.<'NeedttotestthisforeachcommandassomepackqagemayhavechangedRthegstatusofacommandtobGeing`protected'."Thenewde nitionismadeasifwithR\DeclareRobustCommand,UUbutwith\defsyntaxfortheargumentspGeci cation.N117\\def\SK@def#1{% N118f\edef\@tempa{\expandafter\@gobble\string#1}%N119f\@ifundefined{\@tempa\space}%N120o{\expandafter\let\csnameSK@\@tempa\endcsname#1}%N121o{\expandafter\let\csnameSK@\@tempa\expandafter\endcsnameN122T\csname\@tempa\space\endcsname}%N123f\expandafter\def\expandafter#1\expandafter{%N124w^\expandafter\protect\csname\@tempa\space\endcsname}%N125f\expandafter\def\csname\@tempa\space\endcsname}aThefnextsectionrede nes\refand\pageref(unlessthenotrefoptionwas Rgiven).N126\\ifx\SK@ref\@emptyREvenifnotrefoptionisused,sneedtofudgethevariorefngcommandsastheyuseR\labelUUinternally*.N127\\AtBeginDocument{% N128f\ifx\vpageref\@undefined\elseN129o\SK@def\@@vpageref#1[#2]#3{{%N130y2\let\label\SK@labelN131y2\SK@@@vpageref#1[#2]{#3}}}%N132o\DeclareRobustCommand\vref[1]{%N133y2\unskip~\ref{#1}%N134y2{\let\label\SK@labelN135}\SK@@@vpageref\unskip[\unskip\space]{#1}}}%N136f\fi}N137\\else5`\ref "y\pagerefRSave1#therede nitionto\begin{document}sothatthispackqagecanworkwith Rpackqagesthatrede ne\cite.D+T*estedwithharvardandnatbibpackages.D+AlsoaddRcoGdeUUatthispointtosupportvqarioref.N138\\AtBeginDocument{% N139f\SK@def\ref#1{\SK@\SK@@ref{#1}\SK@ref{#1}}%N140f\SK@def\pageref#1{\SK@\SK@@ref{#1}\SK@pageref{#1}}%N141f\ifx\vpageref\@undefined\elseRvqariorefUUsuppGort.N142o\SK@def\@@vpageref#1[#2]#3{{%N143y2\let\label\SK@label\let\ref\SK@ref\let\pageref\SK@pagerefN144y2\leavevmode\unskip\SK@\SK@@ref{#3}\SK@@@vpageref#1[#2]{#3}}}%N145o\DeclareRobustCommand\vref[1]{%N146y2\unskip~\ref{#1}%N147y2{\let\label\SK@label\let\ref\SK@ref\let\pageref\SK@pageref8 O]y?N148}\SK@@@vpageref\unskip[\unskip\space]{#1}}}% N149f\fi}N150\\fiaNowUUrede ne\citeunlessnotciteoptiongiven.N151\\ifx\SK@cite\@emptyN152\\AtBeginDocument{%N153f\ifx\HAR@checkdef\@undefined\elseN154y2\expandafter\let\expandafterN1550\SK@HAR@bi\csname\string\harvarditem\endcsnameN156y2\expandafter\def\csname\string\harvarditem\endcsname[#1]#2#3#4{%N157w^\SK@HAR@bi[#1]{#2}{#3}{#4}\SK@\SK@@label{#4}}%N158f\fi}N159\\else0|\citeN160\\AtBeginDocument{%N161f\ifx\HAR@checkdef\@undefinedRStandardf(non-harvqard)suppGort,khincludingextracitecommandsfromnatbiband Rcite.aIf9citeoroverciteisbGeingused,rede ne\citenratherthan\citesoasnotRtoUUspGoilthespaceandpunctuationcalculationsdonebythosepackqages.N162o\ifx\citen\@undefinedN163y2\SK@def\cite#1#{\SK@citea{#1}}%N164o\elseN165y2\SK@def\citen#1{\SK@\SK@@ref{#1}\SK@citen{#1}}%N166o\fiN167o\SK@def\citeauthor#1{\SK@\SK@@ref{#1}\SK@citeauthor{#1}}%N168o\SK@def\citefullauthor#1{\SK@\SK@@ref{#1}\SK@citefullauthor{#1}}%N169o\SK@def\citeyear#1{\SK@\SK@@ref{#1}\SK@citeyear{#1}}%N170f\elseRIn'theharvard'styledonotrede neindividualcitecommands.#2\SK@{% N183f\leavevmode\vboxto\z@{%N184o\vssN185o\SK@refcolorN186o\rlap{\vrule\raise.75em%N187}\hbox{\underbar{\normalfont\footnotesize\ttfamily#2}}}}}N188\h$5" cmmi9=pack9age#g i10c;y &ow cmss9% cmsy9$5" cmmi9#': cmti10""V cmbx10!m#R cmss10 Cscmtt8