The\ jconfirm\ Confirmation\ Tool\n\nIntroduction\nThe\ jconfirm\ application\ is\ just\ a\ wrapper\ around\ the\ j:confirm\ procedure\ in\ the\ jconfirm.tcl\ library.\ \ It's\ intended\ to\ make\ it\ easy\ to\ ask\ the\ user\ to\ confirm\ an\ action\ from\ shell\ scripts,\ window­manager\ menus,\ etc.\n\nThis\ document\ describes\ jconfirm\ version\ 1998.11.04.\n\nCopyright\ and\ contact\ information\ is\ available\ in\ the\ jstools\ documentation.\n\nInvocation\ and\ Usage\n\tjconfirm\ \[-text\ text\]\ \[-title\ title\]\ \[other\ options\]\n\nInvoking\ jconfirm\ brings\ up\ a\ panel\ displaying\ text\ with\ two\ buttons\ marked\ OK\ and\ Cancel.\ \ The\ panel's\ window­manager\ title\ will\ be\ title.\ \ If\ the\ user\ clicks\ OK,\ jconfirm\ will\ exit\ with\ zero\ status\ (i.e.,\ true,\ in\ shell­script\ terms)\;\ if\ sie\ clicks\ Cancel,\ it\ will\ exit\ with\ non­zero\ (false)\ status.\n\nThere\ are\ a\ few\ other\ options\;\ see\ j:confirm\ in\ the\ jconfirm.tcl\ library\ for\ full\ details.\ \ \ In\ particular,\ you\ can\ specify\ the\ text\ on\ the\ OK\ and\ Cancel\ buttons.\n\nNote,\ however,\ j:confirm's\ -priority\ option\ is\ not\ available\;\ the\ confirmation\ panel\ created\ by\ jconfirm\ will\ appear\ regardless\ of\ the\ user's\ jstools\ preferences.\ \ (The\ jstools\ applications\ generally\ use\ j:confirm\ to\ ask\ the\ user\ to\ confirm\ actions\ sie\ has\ presumably\ requested,\ but\ I\ can\ imagine\ jconfirm\ being\ used\ in\ shell\ scripts\ to\ ask\ questions,\ and\ I\ didn't\ want\ to\ make\ you\ remember\ to\ add\ `-priority\ 100'\ all\ the\ time.)\n\nBoth\ prompt\ and\ title\ are\ localisable.\n\nExample\nif\ jconfirm\ -text\ \"Delete\ your\ home\ directory?\"\ \\\n\ \ \ \ -yesbutton\ Yes\ -nobutton\ No\nthen\n\ \ exec\ /bin/rm\ -rf\ \$HOME\nelse\n\ \ jalert\ -text\ \"Oh,\ where's\ your\ sense\ of\ adventure?\"\nfi\n\nEvolution\nFeel\ free\ to\ report\ bugs\ (and\ feature\ requests)\ to\ me,\ <js@aq.org>,\ and\ I\ will\ try\ to\ deal\ with\ them.\ \ Also,\ feel\ free\ to\ fix\ bugs\ or\ add\ features\ on\ your\ own\ and\ let\ me\ know\ how\ you\ did\ it.\n\n\n\n\n {{{jdoc:anchor:anchorname {3.0 4.0 10.0 11.0 21.0 22.0 30.0 31.0}} {sel {6.41 6.51}} {jdoc:xref:link {4.54 4.63 4.81 4.93 8.0 8.33 8.50 8.75 15.35 15.44 15.52 15.64 19.26 19.37}} {richtext:font:roman {2.0 3.0 4.0 4.4 4.12 4.54 4.63 4.81 4.93 6.24 6.32 8.54 8.61 10.0 11.10 11.11 11.21 11.22 11.23 11.24 11.36 11.37 11.38 11.39 11.52 13.9 13.17 13.47 13.51 13.133 13.138 13.164 13.172 15.35 15.44 15.52 15.64 17.15 17.24 17.27 17.36 17.96 17.104 17.142 17.149 17.169 17.176 17.204 17.213 17.297 17.305 17.399 17.412 19.5 19.11 19.16 19.21 21.0 29.0 30.0 31.0 31.55 31.66 31.190}} {richtext:font:italic {11.17 11.21 11.31 11.36 11.39 11.52 13.47 13.51 13.133 13.138 19.5 19.11 19.16 19.21}} {richtext:font:bold {4.81 4.93 8.54 8.61 15.52 15.64 17.142 17.149 17.169 17.176}} {richtext:font:typewriter {4.4 4.12 4.54 4.63 6.24 6.32 11.0 11.10 11.11 11.17 11.22 11.23 11.24 11.31 11.37 11.38 13.9 13.17 13.164 13.172 15.35 15.44 17.15 17.24 17.27 17.36 17.96 17.104 17.204 17.213 17.297 17.305 17.399 17.412 22.0 29.0 31.55 31.66}} {richtext:font:heading0 {1.0 2.0}} {richtext:font:heading1 {3.0 4.0 10.0 11.0 21.0 22.0 30.0 31.0}} {jdoc:link:jstools.jdoc {8.50 8.75}} {jdoc:anchorname:Introduction {3.0 4.0}} {jdoc:anchorname:Evolution {30.0 31.0}} {jdoc:link:jstools.jdoc#Credits_and_Copyright {8.0 8.33}} {jdoc:anchorname:Invocation_and_Usage {10.0 11.0}} {jdoc:anchorname:Example {21.0 22.0}} {jdoc:link:jconfirm.tcl.jdoc {4.81 4.93 15.52 15.64}} {jdoc:link:jconfirm.tcl.jdoc#j:confirm {4.54 4.63 15.35 15.44}} {jdoc:link:localisable.jdoc {19.26 19.37}}} {{del_from 29.0} {abbrevstart 23.20} {richptr 4.101} {abbrevend 23.31} {insert 6.51} {emacs_mark 1.30} {anchor 1.0} {del_to 29.0} {current 19.38}}} {}