' will be automatically inserted. - (`"^\\(body\\|dl\\|blockquote\\)"') - - -- Variable: yahtml-template-file - File to automatically insert when editing a new HTML file. - `"~/http/template.html"' - - -- Variable: yahtml-prefer-upcases - Use uppercase for tags. `nil' - - -- Variable: yahtml-prefer-upcase-attributes - Use uppercase for attributes. `nil' - - -- Variable: yahtml-server-type - setq to 'apache if using a Apache server, and will refer ./.htaccess. - `'apache' - - -- Variable: yahtml-apache-access-file - When `yahtml-server-type' is `'apache', define name of access - restriction file. `".htaccess"' - - -- Variable: yahtml-shell-command-option - Options needed to invoke shell commands. - - -- Variable: yahtml-translate-hyphens-when-comment-region - Whether to change hyphens to `-' when commenting out region. - (`t') - - -- Variable: yahtml-entity-reference-chars-alist - alist of characters that needs to be written by Entity Reference. - Enter as `'(?char . "EntityReference")'. By default, `<', `>', `&', - `'', is set. Add as needed. Do not include `&' at beginning and `;' - at end of cdr portion of `"EntityReference"'. - - -- Variable: yahtml-faithful-to-htmllint - When using htmllint to check syntax, it will complain about excess - spaces. setq to `t' to avoid this. - - -- Variable: yahtml-use-css - Use style-sheet support or not (`t') - - -- Variable: yahtml-image-inspection-bytes - Number of bytes to inspect the image for geometry information - (`10000') - - -- Variable: yahtml:img-default-alt-format - format of img entity's ALT attributes. %x: width, %y: height, %s: - size in bytes, %c: first comment string, %f: filename - (`"%xx%y(%sbytes)"') - - -- Variable: yahtml-escape-chars - When, completing href-s, Escape reserved characters to URL-encoding - or not. Nil for never, t for everytime, and 'ask for inquiring at - each reserved chars. (`'ask') - - -- Variable: yahtml-use-font-lock - Use font-lock to fontify buffer or not (`(featurep 'font-lock)') - - -- Variable: yahtml-use-hilit19 - Use hilit19 to highlight buffer or not (`(featurep 'hilit19)') - - -- Variable: yahtml-indentation-boundary - Boundary regexp for indentation calculation. (`"^\\s *"') - - - -File: yahtmle, Node: Hook variables, Prev: All customizable variables, Up: Customizations - -hook variables -============== - - - - -File: yahtmle, Node: Copying, Next: Concept Index, Prev: Customizations, Up: Top - -Copying -******* - -This program is distributed as freesoftware. The author will take no -responsibility to any damages due to the usage of this software -whatsoever. There are no restrictions to its redistribution, just use -common sense. Mail me your thoughts on this program and I will be more -than willing to help. - -Complaints, requests, bug reports and comments are welcome. Make contacts -to yuuji@yatex.org$B!!(B(as of December 2000) - -If you like this program and use it on a regular basis, please join the -mailing list "fj Wild Bird Society". Procedures can be found in the "etc" -section of `docs/htmlqa.eng' in this package. - - - HIROSE, Yuuji - - - - -File: yahtmle, Node: Concept Index, Prev: Copying, Up: Top - -Index -***** - -* Menu: - -* Customize: Customizations. 4. -* Demacs: Intro. 4. -* Key Assign: Customizations. 4. -* LaTeX: Intro. 4. -* Mule: Intro. 4. -* yahtml: Intro. 4. - - - - - -Tag table: -Node: Top148 -Node: Intro725 -Node: Installation1123 -Node: Setting up yahtml1404 -Node: Setting environments for weblint browsers and image viewers2195 -Node: Setting environment variables for WWW pages2891 -Node: Command Invocation3862 -Node: Completion4290 -Node: Jump5807 -Node: Changing and Deleting6287 -Node: Changing tags in pairs6538 -Node: Changing entities7033 -Node: URLencoding of strings within region7569 -Node: td-enclosure/tr-enclosure7870 -Node: CSS Support8836 -Node: CSS-class completion9062 -Node: Reread CSS definition9915 -Node: Customizations10190 -Node: All customizable variables10466 -Node: Hook variables14234 -Node: Copying14360 -Node: Concept Index15151 - -End tag table +Info file: yahtmle, -*-Text-*- +produced by `texinfo-format-buffer' +from file `yahtmle.tex' +using `texinfmt.el' version 2.38 of 3 July 1998. + + + + + + +File: yahtmle, Node: Top, Next: Intro, Prev: (dir), Up: (dir) + +* Menu: + +* Intro:: Introduction +* Installation:: Installing yahtml +* Command Invocation:: Using External Commands +* Completion:: Input with Completion +* Jump:: Moving the Cursor +* Changing and Deleting:: Changing and Deleting +* CSS Support:: Style Sheet Support +* Customizations:: List of Customize Variables +* Copying:: Copyright +* Concept Index:: Index + + + +File: yahtmle, Node: Intro, Next: Installation, Prev: Top, Up: Top + +Introduction +************ + +yahtml is a package to support creating HTML documents on Emacsens. Easy +input of elements (tags) by completion, syntax checking with programs like +weblint, and invoking the appropriate browser or image viewer depending on +the cursor position is its main features. + +(This Info is still incomplete) + + + +File: yahtmle, Node: Installation, Next: Command Invocation, Prev: Intro, Up: Top + +Installing yahtml +***************** +* Menu: + +* Setting up yahtml:: +* Setting environments for weblint browsers and image viewers:: +* Setting environment variables for WWW pages:: + + + +File: yahtmle, Node: Setting up yahtml, Next: Setting environments for weblint browsers and image viewers, Prev: Installation, Up: Installation + +Setting up yahtml +================= + + +Add the following to `~/.emacs' + + (setq auto-mode-alist + (cons (cons "\\.html$" 'yahtml-mode) auto-mode-alist)) + (autoload 'yahtml-mode "yahtml" "Yet Another HTML mode" t) + +Next, add to load-path the directory with the yahtml files (`yahtml.el', +`yatexlib.el', `yatexprc.el'). For example, if you put them in +`~/src/emacs/yahtml', + + (setq load-path (cons (expand-file-name "~/src/emacs/yahtml") load-path)) + +is what you add. + +By this, yahtml will be automatically loaded when editing files with .html +extensions. "yahtml" will be displayed on the mode line if no errors +occurred. + + + +File: yahtmle, Node: Setting environments for weblint browsers and image viewers, Next: Setting environment variables for WWW pages, Prev: Setting up yahtml, Up: Installation + +Setting environments for weblint, browsers, and image viewers +============================================================= + +Check the variables for invoking external commands and modify as needed. +Defaults are in parenthesis. + +`yahtml-www-browser' + ... browser command name (netscape) +`yahtml-image-viewer' + ... image viewer command name (xv) +`yahtml-lint-program' + ... syntax check programs command name (jweblint) +`yahtml-kanji-code' + ... kanji code for HTML files + + + +File: yahtmle, Node: Setting environment variables for WWW pages, Prev: Setting environments for weblint browsers and image viewers, Up: Installation + +Setting environment variables for WWW pages +=========================================== + +Variables regarding path names for files that will be your home page. +`yahtml-path-url-alist' + ... list of matching path name on file system and URLs +`yahtml-directory-index' + ... index file displayed when none is given in URL. Usually + `index.html' on NCSA type httpd and `Welcome.html' on CERN types. + +Examples for `yahtml-path-url-alist'. If `/home/yuuji/http/' is +`http://localhost/~yuuji' at home and `/usr/home/yuuji/www/' is +`http://www.keio.ac.jp/~yuuji/' at work, then + + (setq yahtml-path-url-alist + '(("/home/yuuji/http" . "http://localhost/~yuuji") + ("/usr/home/yuuji/www" . "http://www.keio.ac.jp/~yuuji"))) + +Any number of additions can be made to this list. + + + +File: yahtmle, Node: Command Invocation, Next: Completion, Prev: Installation, Up: Top + +Invoking external commands +************************** + +For easy use of commands that are handy when editing HTML files. +`[prefix] t j' + ... Invoke HTML syntax checker (jweblint) +`[prefix] t p' + ... Display current page in browser +`[prefix] t r' + ... Reload current page if browser is already running + + + +File: yahtmle, Node: Completion, Next: Jump, Prev: Command Invocation, Up: Top + +Completion Input +**************** + +Completion input of HTML elements is done through the same key strokes as +YaTeX's begin-type completion, section-type completion, large-type +completion, maketitle-type completion, and accent completion. +Corresponding elements in this order is; elements that span multiple +lines, empty elements such as img, tags that start and end in a single +line, elements with no attributes or contents, and special or symbol +entities. + +`[prefix] b (YaTeX begin-type completion)' + ... + + + + Completion for elements that the start tag and the end tag span + multiple lines. Mostly block-level elements. + +`[prefix] s (YateX section-type completion)' + ... + + + Completion for elements that do not have end tags and require only + attributes. Possible completions are, , . + +`[prefix] l (YaTeX large-type completion)' + ... + + �` + + Similar to begin-type completion but used for elements that start and + end on a single line. + + +`[prefix] m (YaTeX maketitle-type completion)' + ... Completion for elements without attributes or contents. Possible + completion is + +`[prefix] a (YaTeX accent completion)' + ... Used to enter special or symbol entities. By default completion + for < (<), > (>), & (&), " ("), ' ('), blank + ( ) is possible. + + + +File: yahtmle, Node: Jump, Next: Changing and Deleting, Prev: Completion, Up: Top + +Cursor Movement +*************** +By using + +`[prefix] g' + ... move to corresponding object + +the cursor will go to the corresponding object according to the context. +Recognized contexts are + + * `' <--> `' + * `' -> invoke viewer + * `' -> move cursor to linked target + * `' -> open Java source + + + +File: yahtmle, Node: Changing and Deleting, Next: CSS Support, Prev: Jump, Up: Top + +Changing and Deleting +********************* + +* Menu: + +* Changing tags in pairs:: +* Changing entities:: +* URLencoding of strings within region:: +* td-enclosure/tr-enclosure:: + + + +File: yahtmle, Node: Changing tags in pairs, Next: Changing entities, Prev: Changing and Deleting, Up: Changing and Deleting + +Changing tags in pairs +====================== +By using + +`[prefix] c' + ... change tags in matching pairs + +the content can be changed according to the context of the HTML document +where the cursor is located. + + * `'�``' + ... change `TAG' element name + * attributes such as `' + ... change attributes + + + +File: yahtmle, Node: Changing entities, Next: URLencoding of strings within region, Prev: Changing tags in pairs, Up: Changing and Deleting + +Changing entities +================= +Special characters such as < or > must be written as < and >. Easy +conversion of these characters can be done when importing text from non +HTML files. + + +`[prefix] ;' + ... convert char to special entity in marked region +`[prefix] :' + ... convert special entity to original char in marked region + (reverse of [prefix] ;) + + + + +File: yahtmle, Node: URLencoding of strings within region, Next: td-enclosure/tr-enclosure, Prev: Changing entities, Up: Changing and Deleting + +URLencoding of strings within region +==================================== + +`[prefix] #' + ... encode chars that needs to be URLencoded within region + + + +File: yahtmle, Node: td-enclosure/tr-enclosure, Prev: URLencoding of strings within region, Up: Changing and Deleting + +td-enclosure/tr-enclosure +========================= +If you wan to convert series of field into ... repetitions for +table element, td-enclosure or tr-enclosure is convenient. + + `[prefix] }' + + ... Enclose each field in a region into ...'s. + `[prefix] ]' + + ... Enclose each line in a region into ...'s, with every +line converted to ... repetition. They presume white space as +field separator by default. To change this, enter other delimiting +character for a query. You can convert CSV, for example, into table by +specifying comma(,) as a delimiter. + +If you want to enclose fields with th, call with universal-argument +(`C-u'). Enter `th' to enclose fields with .... The special +answer `thd' means that enclose the only first column with th, and the +rest with td. + + + +File: yahtmle, Node: CSS Support, Next: Customizations, Prev: Changing and Deleting, Up: Top + +CSS(Style Sheets) Support +************************* + +* Menu: + +* CSS-class completion:: +* Reread CSS definition:: + + + +File: yahtmle, Node: CSS-class completion, Next: Reread CSS definition, Prev: CSS Support, Up: CSS Support + +CSS class-name completion +========================= +You can input a class name in your CSS definition with completion. If you +have CSS defined as below; + + h1.foo, h2.foo { background-color: 0xffffff; } + h1.bar, h2.bar { font-size: 120%; } + +when you input h1(or h2) tag with completing-read by [prefix] b or +[prefix] l, yahtml prompts you to input class name with completion from +the words which are effective to h1 or h2. And if you defined global +class like this; + + .caution { font-size: 120%; background-color: 0xc00000;} + +when you input any tags via completing-read, yahtml prompts you to input +class name. If this is bothering, typing `C-j' instead of `RET' (or +`C-m') cancels the next prompt to class name completion. + + + +File: yahtmle, Node: Reread CSS definition, Prev: CSS-class completion, Up: CSS Support + +Re-reading CSS definition +========================= +If you add some class to your CSS file and you want yahtml to load new +definitions, type `M-x yahtml-mode RET' to make yahtml do. + + + +File: yahtmle, Node: Customizations, Next: Copying, Prev: CSS Support, Up: Top + +Customizations +************** + +Variables that modify yahtml's behavior. + +* Menu: + +* All customizable variables:: List of customizable variables +* Hook variables:: hook variables + + + +File: yahtmle, Node: All customizable variables, Next: Hook variables, Prev: Customizations, Up: Customizations + +List of customizable variables. Defaults in parenthesis +======================================================== + + -- Variable: yahtml-prefix + Prefix key for yahtml-mode. (`\C-c') + + -- Variable: yahtml-image-viewer + Command to view image files refered by img. (xv) + + -- Variable: yahtml-www-browser + Browser to view external pages with `[prefix]g'. (netscape) + + -- Variable: yahtml-kanji-code + Default kanji code. 1=sjis, 2=jis, 3=euc, 4=utf-8 (2) If AddType + "text/html; charset=xxx" .html is written in .htaccess, this will + override yahtml-kanji-code. + + -- Variable: yahtml-fill-column + Columns to auto-fill (72) + + -- Variable: yahtml-fill-prefix + fill-prefix specific to yahtml-mode. (`nil') + + -- Variable: yahtml-path-url-alist + Matching list of URL and full path name on OS's file system. + + -- Variable: yahtml-directory-index + Default index filed opened when accessing a server without a + filename, usually index.html. (`"index.html"') + + -- Variable: yahtml-lint-program + HTML syntax check program. (`"jweblint"') + + -- Variable: yahtml-hate-too-deep-indentation + setq to t when indentations for nested enumerate elements are too + deep. (`nil') + + -- Variable: yahtml-always-/p + setq to t if you always want `
' will be automatically inserted. + (`"^\\(body\\|dl\\|blockquote\\)"') + + -- Variable: yahtml-template-file + File to automatically insert when editing a new HTML file. + `"~/http/template.html"' + + -- Variable: yahtml-prefer-upcases + Use uppercase for tags. `nil' + + -- Variable: yahtml-prefer-upcase-attributes + Use uppercase for attributes. `nil' + + -- Variable: yahtml-server-type + setq to 'apache if using a Apache server, and will refer ./.htaccess. + `'apache' + + -- Variable: yahtml-apache-access-file + When `yahtml-server-type' is `'apache', define name of access + restriction file. `".htaccess"' + + -- Variable: yahtml-shell-command-option + Options needed to invoke shell commands. + + -- Variable: yahtml-translate-hyphens-when-comment-region + Whether to change hyphens to `-' when commenting out region. + (`t') + + -- Variable: yahtml-entity-reference-chars-alist + alist of characters that needs to be written by Entity Reference. + Enter as `'(?char . "EntityReference")'. By default, `<', `>', `&', + `'', is set. Add as needed. Do not include `&' at beginning and `;' + at end of cdr portion of `"EntityReference"'. + + -- Variable: yahtml-faithful-to-htmllint + When using htmllint to check syntax, it will complain about excess + spaces. setq to `t' to avoid this. + + -- Variable: yahtml-use-css + Use style-sheet support or not (`t') + + -- Variable: yahtml-image-inspection-bytes + Number of bytes to inspect the image for geometry information + (`10000') + + -- Variable: yahtml:img-default-alt-format + format of img entity's ALT attributes. %x: width, %y: height, %s: + size in bytes, %c: first comment string, %f: filename + (`"%xx%y(%sbytes)"') + + -- Variable: yahtml-escape-chars + When, completing href-s, Escape reserved characters to URL-encoding + or not. Nil for never, t for everytime, and 'ask for inquiring at + each reserved chars. (`'ask') + + -- Variable: yahtml-use-font-lock + Use font-lock to fontify buffer or not (`(featurep 'font-lock)') + + -- Variable: yahtml-use-hilit19 + Use hilit19 to highlight buffer or not (`(featurep 'hilit19)') + + -- Variable: yahtml-indentation-boundary + Boundary regexp for indentation calculation. (`"^\\s *"') + + + +File: yahtmle, Node: Hook variables, Prev: All customizable variables, Up: Customizations + +hook variables +============== + + + + +File: yahtmle, Node: Copying, Next: Concept Index, Prev: Customizations, Up: Top + +Copying +******* + +This program is distributed as freesoftware. The author will take no +responsibility to any damages due to the usage of this software +whatsoever. There are no restrictions to its redistribution, just use +common sense. Mail me your thoughts on this program and I will be more +than willing to help. + +Complaints, requests, bug reports and comments are welcome. Make contacts +to yuuji@yatex.org�@(as of December 2000) + +If you like this program and use it on a regular basis, please join the +mailing list "fj Wild Bird Society". Procedures can be found in the "etc" +section of `docs/htmlqa.eng' in this package. + + + HIROSE, Yuuji + + + + +File: yahtmle, Node: Concept Index, Prev: Copying, Up: Top + +Index +***** + +* Menu: + +* Customize: Customizations. 4. +* Demacs: Intro. 4. +* Key Assign: Customizations. 4. +* LaTeX: Intro. 4. +* Mule: Intro. 4. +* yahtml: Intro. 4. + + + + +Tag table: +Node: Top151 +Node: Intro728 +Node: Installation1126 +Node: Setting up yahtml1407 +Node: Setting environments for weblint browsers and image viewers2198 +Node: Setting environment variables for WWW pages2894 +Node: Command Invocation3865 +Node: Completion4293 +Node: Jump5809 +Node: Changing and Deleting6289 +Node: Changing tags in pairs6573 +Node: Changing entities7068 +Node: URLencoding of strings within region7604 +Node: td-enclosure/tr-enclosure7905 +Node: CSS Support8871 +Node: CSS-class completion9097 +Node: Reread CSS definition9950 +Node: Customizations10225 +Node: All customizable variables10501 +Node: Hook variables14269 +Node: Copying14395 +Node: Concept Index15186 + +End tag table diff --git a/docs/yahtmle.tex b/docs/yahtmle.tex index 6582d72..82fbe9c 100644 --- a/docs/yahtmle.tex +++ b/docs/yahtmle.tex @@ -5,7 +5,7 @@ @iftex @c @syncodeindex fn cp -@c Last modified Sun Apr 15 22:52:03 2012 on firestorm +@c Last modified Thu May 10 11:13:19 2012 on firestorm @syncodeindex vr cp @end iftex @@ -15,7 +15,7 @@ @subtitle Yet Another html-mode for emacs @title // yahtml // %@subtitle // yahtml // -@author @copyright{} 1994-1997 by HIROSE, Yuuji [yuuji@@yatex.org] +@author @copyright{} 1994-2012 by HIROSE, Yuuji [yuuji@@yatex.org] @end titlepage @node Top, Intro, (dir), (dir) diff --git a/docs/yahtmlj b/docs/yahtmlj index b4fdb18..6fbb027 100644 --- a/docs/yahtmlj +++ b/docs/yahtmlj @@ -1,542 +1,541 @@ -Info file: yahtmlj, -*-Text-*- -produced by `texinfo-format-buffer' -from file `yahtmlj.tex' -using `texinfmt.el' version 2.38 of 3 July 1998. - - - - - - -File: yahtmlj, Node: Top, Next: Intro, Prev: (dir), Up: (dir) - -* Menu: - -* Intro:: $(B$O$8$a$K -(B* Installation:: $(B%$%s%9%H!<%k -(B* Command Invocation:: $(B30It%3%^%s%I5/F0 -(B* Completion:: $(BJd40F~NO -(B* Jump:: $(B%+!<%=%k%8%c%s%W -(B* Changing and Deleting:: $(BJQ99$H:o=| -(B* CSS Support:: $(B%9%?%$%k%7!<%HJd40 -(B* Customizations:: $(B%+%9%?%^%$%:JQ?t0lMw -(B* Copying:: $(B$H$j$"$D$+$$ -(B* Concept Index:: $(B:w0z - - - - -(BFile: yahtmlj, Node: Intro, Next: Installation, Prev: Top, Up: Top - -$(B$O$8$a$K -(B******** - -yahtml$(B$O (BGNU Emacs $(B>e$G (BHTML$(BJ8=q$r:n@.$9$k;~$K!"HK;($J(BHTML$(B%?%0$NF~NO$rJd40 -5!G=$K$h$C$F%9%`!<%:$K9T$($k$h$&$K$9$k$@$1$G$J$/!"(Bweblint$(B$J$I$N9=J8%A%'%C -%/%W%m%0%i%`!"%+!<%=%k0LCV$N(BURL$(B$d%U%!%$%kL>$K0MB8$7$?%V%i%&%6(B/$(B%$%a!<%8%t%e!< -%"$N5/F0$J$I$r (BEmacs $(BJT=82hLLCf$+$i9T$($k$h$&$K$9$k%Q%C%1!<%8$G$9!# - -(B($(B$3$N(BInfo$(B$OL$40@.$G$9(B(__)$(B!D(B) - - - -File: yahtmlj, Node: Installation, Next: Command Invocation, Prev: Intro, Up: Top - -$(B%$%s%9%H!<%k -(B************ -* Menu: - -* yahtml$(B5/F0$N$?$a$N@_Dj(B:: -* lint$(B%W%m%0%i%`(B/$(B%V%i%&%6(B/$(B%$%a!<%8%t%e!<%"4D6-Ey$N@_Dj(B:: -* WWW$(B%Z!<%84D6-MQJQ?t$N@_Dj(B:: - - - -File: yahtmlj, Node: yahtml$(B5/F0$N$?$a$N@_Dj(B, Next: lint$(B%W%m%0%i%`(B/$(B%V%i%&%6(B/$(B%$%a!<%8%t%e!<%"4D6-Ey$N@_Dj(B, Prev: Installation, Up: Installation - -yahtml$(B5/F0$N$?$a$N@_Dj -(B====================== - - -`~/.emacs'$(B$K2<$N(B2$(B9`L\$r2C$($^$9!# - - (B(setq auto-mode-alist - (cons (cons "\\.html$" 'yahtml-mode) auto-mode-alist)) - (autoload 'yahtml-mode "yahtml" "Yet Another HTML mode" t) - -$(Be$N@_Dj$K$h$j!"3HD%;R$, (B.html $(B$G$"$k%U%!%$%k$rJT=8$9$k$H<+F0E*$K -(Byahtml $(B$,%m!<%I$5$l$^$9!#(Byahtml$(B$,@5>o$K5/F0$G$-$?$H$-$O%b!<%I%i%$%s$NI=<( -$,!V(Byahtml$(B!W$KJQ$o$j$^$9!# - - - -(BFile: yahtmlj, Node: lint$(B%W%m%0%i%`(B/$(B%V%i%&%6(B/$(B%$%a!<%8%t%e!<%"4D6-Ey$N@_Dj(B, Next: WWW$(B%Z!<%84D6-MQJQ?t$N@_Dj(B, Prev: yahtml$(B5/F0$N$?$a$N@_Dj(B, Up: Installation - -lint$(B%W%m%0%i%`(B/$(B%V%i%&%6(B/$(B%$%a!<%8%t%e!<%"4D6-Ey$N@_Dj -(B==================================================== - -$(BMxMQ$9$k30It%W%m%0%i%`$J$I$K4X$9$k0J2<$NJQ?t$r3NG'$7!"I,MW$J$i@5$7$$CM$KJQ -99$7$^$9(B($(B3g8LFb$O%G%U%)%k%HCM(B)$(B!# -(B`yahtml-www-browser' - ... $(B5/F0$9$k%V%i%&%6$N%3%^%s%IL>(B(netscape) -`yahtml-image-viewer' - ... $(B5/F0$9$k2hA|%S%e!<%"$N%3%^%s%IL>(B(xv) -`yahtml-lint-program' - ... $(B9=J8%A%'%C%/%W%m%0%i%`$N%3%^%s%IL>(B(jweblint) -`yahtml-kanji-code' - ... html$(B%U%!%$%k$N4A;z%3!<%I - - - -(BFile: yahtmlj, Node: WWW$(B%Z!<%84D6-MQJQ?t$N@_Dj(B, Prev: lint$(B%W%m%0%i%`(B/$(B%V%i%&%6(B/$(B%$%a!<%8%t%e!<%"4D6-Ey$N@_Dj(B, Up: Installation - -WWW$(B%Z!<%84D6-MQJQ?t$N@_Dj -(B========================= - -$(B%[!<%`%Z!<%8$H$J$k%U%!%$%k$,B8:_$9$k(BPATH$(BL>$K4X$9$kJQ?t$r@_Dj$7$^$9!# -(B`yahtml-path-url-alist' - ... $(B%U%!%$%k%7%9%F%`>e$N(BPATH$(BL>$H!"(BURL$(B$NBP1~I= -(B`yahtml-directory-index' - ... URL$(B;XDj$G%U%!%$%kL>$r>JN,$7$?$H$-$KI=<($5$l$k%$%s%G%C%/%9 - %U%!%$%kL>(B(NCSA$(B7O(Bhttpd$(B$J$i (B`index.html', CERN$(B7O$J$i(B`Welcome.html'$(B$,0l - HLE*(B) - -$(BJQ?t (B`yahtml-path-url-alist' $(B$N@_DjNc$r<($7$^$9!#Nc$($P!"<+Bp$G$O!" -(B`/home/yuuji/http/' $(B$, (B`http://localhost/~yuuji' $(B$G;2>H$G$-!"?&>l$G$O -(B`/usr/home/yuuji/www/' $(B$,(B`http://www.keio.ac.jp/~yuuji/' $(B$G;2>H$G$-$k$h$& -$K$J$C$F$$$k>l9g$O0J2<$N$h$&$K@_Dj$7$^$9!# - - (B(setq yahtml-path-url-alist - '(("/home/yuuj/http" . "http://localhost/~yuuji") - ("/usr/home/yuuj/www" . "http://www.keio.ac.jp/~yuuji"))) - -$(B$3$NBP1~AH$O$$$/$i$G$b@_Dj$9$k$3$H$,$G$-$^$9!# - - - -(BFile: yahtmlj, Node: Command Invocation, Next: Completion, Prev: Installation, Up: Top - -$(B30It%3%^%s%I5/F0 -(B**************** - -HTML$(B%U%!%$%kJT=8$K$+$+$o$k$$$/$D$+$N%3%^%s%I$rB(:B$K8F$V$3$H$,$G$-$^$9!# -(B`[prefix] t j' - ... HTML$(B9=J8%A%'%C%+(B(jweblint)$(B5/F0 -(B`[prefix] t p' - ... $(B8=:_$N%Z!<%8$rBP>]$H$7$?%V%i%&%65/F0 -(B`[prefix] t r' - ... $(B8=:_$N%Z!<%8$,%V%i%&%6$KI=<($5$l$F$$$k$H$-$N(Breload$(B;XDj - - - -(BFile: yahtmlj, Node: Completion, Next: Jump, Prev: Command Invocation, Up: Top - -$(BJd40F~NO -(B******** - -$(B!VLnD;!W$GMxMQ$G$-$k!"!V(Bbegin$(B7?Jd40!W!"!V(Bsection$(B7?Jd40!W!"!V(Blarge$(B7?Jd40!W!" -!V(Bmaketitle$(B7?Jd40!W!"!V%"%/%;%s%HJd40!W$HA4$/F1$8%-!$l$N7?$NJd40$O=g$K!"!VJ#?t9T$KEO$k%?%0F~NO!W!" -!V6uMWAG%?%0(B(img$(B$J$I(B)$(B$NJd40!W!"!V0l9TFb$G$N3+;O(B/$(B=*N;%?%0$NF~NO!W!"!V6uMWAG -6uB0@-%?%0$NF~NO!W!"!VJ8;z;2>HF~NO!W$KBP1~$7$F$$$^$9!#6qBNE*$K$O - -(B`[prefix] b ($(BLnD;$N(Bbegin$(BJd40$KBP1~(B)' - ... - - - - $(B$N$h$&$K3+;O%?%0$H=*N;%?%0$rFs9T$KEO$C$F=q$-$?$$>l9g$NJd40$r;X$7$^$9!# - $*$b$K%V%m%C%/7?%?%0$,Jd408uJd$K4^$^$l$^$9!# - -(B`[prefix] s ($(BLnD;$N(Bsection$(B7?Jd40$KBP1~(B)' - ... - - - $(B$N$h$&$K=*N;%?%0$r;}$?$:!"$+$DB0@-CM$N$_$G5!G=$r;XDj$9$k%?%0$rJd40$7 - $^$9!#Jd408uJd$H$7$F$O!"(Bimg, input $(B$,B8:_$7$^$9!# - -(B`[prefix] l ($(BLnD;$N(Blarge$(B7?Jd40$KBP1~(B)' - ... begin$(B7?Jd40$H$[$\F1$8$G$9$,!" - - (B $(B!A (B - - $(B$N$h$&$K0l9TFb$K3+;O(B/$(B=*N;%?%0$rF~$l$?$$$H$-$KMxMQ$7$^$9!# - -(B`[prefix] m ($(BLnD;$N(Bmaketitle$(B7?Jd40$KBP1~(B)' - ... $(BMWAG$bB0@-CM$b;}$?$J$$%?%0$rJd40F~NO$7$^$9!#(B - $(B$J$I$,Jd408uJd$KAjEv$7$^$9!# - -(B`[prefix] a ($(BLnD;$N%"%/%;%s%HJd40$KBP1~(B)' - ... $(B%(%s%F%#%F%#;2>H$K$h$kJ8;zI=5-$rF~NO$9$k$H$-$KMQ$$$^$9!# - %G%U%)%k%H$G$O (B< (<), > (>), & (&), " ("), ' ('), - $(B%V%i%s%/ (B( ) $(B$NJd40F~NO$,9T$($^$9!# - - - -(BFile: yahtmlj, Node: Jump, Next: Changing and Deleting, Prev: Completion, Up: Top - -$(B%+!<%=%k%8%c%s%W -(B**************** -$(BJ8=qCf$N$$$m$$$m$J>l=j$G - -(B`[prefix] g' - ... $(BBP1~$9$k%*%V%8%'%/%H$K%8%c%s%W - -$r2!$9$3$H$K$h$j!"%+!<%=%k0LCV$N(BHTML$(B9=J8$KBP1~$9$k>l=j$K%8%c%s%W$7$^$9!#BP -1~4X78$,B8:_$9$k$H2r' $(B"+"* (B`' - * `' $(B"* BP1~$9$k(Bviewer$(B5/F0 - (B* `' $(B"* %j%s%/@h$X$N%]%$%s%H0\F0 - (B* `' $(B"* (BJava$(B%=!<%9%W%m%0%i%`$X$N0\F0 - - - -(BFile: yahtmlj, Node: Changing and Deleting, Next: CSS Support, Prev: Jump, Up: Top - -$(BJQ99(B/$(B:o=| -(B********* - -* Menu: - -* $(BBP%?%0$NJQ99(B:: -* $(BJ8;z;2>H$X$NJQ99(B:: -* $(B%j%8%g%sFbJ8;z$N(BURLencode:: -* td$(B3g$j(B/tr$(B3g$j(B:: - - - -File: yahtmlj, Node: $(BBP%?%0$NJQ99(B, Next: $(BJ8;z;2>H$X$NJQ99(B, Prev: Changing and Deleting, Up: Changing and Deleting - -$(BBP%?%0$NJQ99 -(B============ -$(BJ8=qCf$N$$$m$$$m$J>l=j$G - -(B`[prefix] c' - ... $(BBP1~$9$k%?%0Ey$rJQ99 - -$r2!$9$3$H$K$h$j!"%+!<%=%k0LCV$N(BHTML$(B9=J8$K1~$8$?5-=RFbMF$NJQ99$r9T$$$^$9!# -%+!<%=%k0LCV$HJQ99$9$kFbMF$NBP1~$O0J2<$NDL$j$G$9!# - - (B* `'$(B!A(B`' - ... `TAG' $(B$NJQ99 - (B* `' $(B$J$I$NB0@-CM - (B... $(BB0@-CM$NJQ99 - - - -(BFile: yahtmlj, Node: $(BJ8;z;2>H$X$NJQ99(B, Prev: $(BBP%?%0$NJQ99(B, Up: Changing and Deleting - -$(BJ8;z;2>H$X$NJQ99 -(B================ -$(BJ8;z$H$7$F$N (B< $(B$d (B> $(B$rI=8=$9$k$H$-$O!"J8;z;2>H$rMQ$$$F(B< $(B$d (B> $(B$HI=5- -$9$kI,MW$,$"$j$^$9$,!"(BHTML$(B0J30$N%U%!%$%k$+$i$3$l$i$NJ8;z$r4^$`%F%-%9%H$rD% -$j9~$s$@>l9g$J$I$K!"$3$l$i$NJ8;z$r0l3g$7$FJ8;z;2>H7A<0$KJQ49$G$-$^$9!# - -(B`[prefix] ;' - ... $(B;XDj$7$?NN0h$NJ8;z;2>H$KCV$-49$($k$Y$-J8;z$NCV49 -(B`[prefix] :' - ... $(B;XDj$7$?NN0h$NJ8;z;2>H$r;2>HJ8;z$=$N$b$N$KCV49(B([prefix] ; - $(B$N5UJQ49(B) - - - - -File: yahtmlj, Node: $(B%j%8%g%sFbJ8;z$N(BURLencode, Next: td$(B3g$j(B/tr$(B3g$j(B, Prev: $(BJ8;z;2>H$X$NJQ99(B, Up: Changing and Deleting - -$(B%j%8%g%sFbJ8;z$N(BURLencode -========================= - [prefix] # - - ... $(B;XDj$7$?NN0hFb$K (BURLencode $(B$9$Y$-J8;z$,$"$l$P$=$l$i$r%(%s - %3!<%II=5-$KCV49!# - - - -(BFile: yahtmlj, Node: td$(B3g$j(B/tr$(B3g$j(B, Prev: $(B%j%8%g%sFbJ8;z$N(BURLencode, Up: Changing and Deleting - -td$(B3g$j(B/tr$(B3g$j -(B============= -$(B6uGr6h@Z$j$G=q$$$?I=7A<0$N9T%l%3!<%I$r (B $(B3g$j$NJB$S!$$"$k$$$O$=$l$i$r$5 -$i$K (B $(B$G3g$C$?9TJB$S$KJQ49$G$-$^$9!# - (B`[prefix] '} - - ... $(B8=:_$N%j%8%g%s$K$"$k%G!<%?$r6uGr6h@Z$j$4$H$K - (B... $(B$G3g$k - (B`[prefix] ]' - - ... $(B8=:_$N%j%8%g%s$K$"$k9T$r>e5-(Btd$(B3g$j$r$[$I$3$7$F$+$i$5$i$K9T$4$H -$K (B... $(B$G3g$k%G%U%)%k%H$G$O6uGr6h@Z$j$G$9$,!$$3$l$rJQ$($k$H$-$O -(BDelimiter: $(B$NLd$$9g$o$;$K6h@Z$jJ8;z$r;XDj$7$^$9!#$?$H$($P%+%s%^(B(,) $(B$r;XDj -$9$k$H(BCSV$(B$+$iI=$r:n$k$3$H$,$G$-$^$9!# - -(Btd$(B0J30$NMWAG!$6qBNE*$K$O (Bth $(B$G3g$j$?$$>l9g$O (Buniversal-argument (`C-u') $(B$r -$D$1$F>e5-(B2$(B$D$N%3%^%s%I$r8F$S$^$9!#$I$NMWAG$G3g$k$+$N... $(B$G3g$j$^$9!#$b$7!$Bh(B1$(B%U%#!< -%k%I$N$_ (Bth $(B$G!$;D$j$rA4It (Btd $(B3g$j$K$7$?$$$H$-$O (Bthd $(B$HF~NO$7$F2<$5$$!# - - - -(BFile: yahtmlj, Node: CSS Support, Next: Customizations, Prev: Changing and Deleting, Up: Top - -CSS($(B%9%?%$%k%7!<%H(B)$(B%5%]!<%H -(B*************************** - -* Menu: - -* CSS-class completion:: -* Reread CSS file:: - - - -File: yahtmlj, Node: CSS-class completion, Next: Reread CSS file, Prev: CSS Support, Up: CSS Support - -CSS$(B%/%i%9L>Jd40 -(B=============== -HTML$(B20$O(BCSS(Cascading Style Sheets)$(B$N%/%i%9L>$rJd40F~NO$9$k$3$H$,$G$-$^$9!# -%9%?%$%kDj5A$H$7$F - - (Bh1.foo, h2.foo { background-color: 0xffffff; } - h1.bar, h2.bar { font-size: 120%; } - -$(B$N$h$&$J$b$N$,$"$C$?>l9g$K!"(Bh1$(B$^$?$O(Bh2$(B%?%0$r (B[prefix] b $(B$d (B[prefix] l $(B$GJd -40F~NO$7$?>l9g$K!"$=$l$i$KM-8z$J (Bclass $(BL>$G$"$k (Bfoo, bar $(B$r8uJd$H$7$FJd40 -F~NO$9$k$3$H$,2DG=$G$9!#$^$? - - (B.caution { font-size: 120%; background-color: 0xc00000;} - -$(B$N$h$&$JA4$F$N%(%l%a%s%H$KF/$/(Bclass$(B$,Dj5A$5$l$F$$$?>l9g$O!"A4$F$N%?%0$NJd -40F~NO;~$K(Bclass$(B;2>HF~NO$r5a$a$i$l$^$9!#$3$l$,HQ$o$7$$>l9g$O%(%l%a%s%HL>F~ -NO3NDj$N$H$-$K%j%?!<%s%-!<(B($(B$^$?$O(BC-m)$(B$G$O$J$/!"(BC-j$(B$r2!$;$P(Bclass$(BJd40F~NO$r -%-%c%s%;%k$G$-$^$9!#$?$H$($P - - (B`[prefix] l' $(B9TFb%?%0Jd40$r5/F0 - (B($(B$^$?$O(B`[prefix] l SPC') - tt $(B$r$$$l$?$$$N$G(Btt$(B$HF~NO - (B`C-m' - -$(B$H$7$?>l9g$OB3$$$F (Bclass= $(B$HJd40%W%m%s%W%H$,=P$^$9$,!" - - (B`[prefix] l' $(B9TFb%?%0Jd40$r5/F0 - (B($(B$^$?$O(B`[prefix] l SPC') - tt $(B$r$$$l$?$$$N$G(Btt$(B$HF~NO - (B`C-j' - -$(B$H:G8e$r (B`C-j' $(B$GF~NO$7$?>l9g$O (Bclass $(BJd40%W%m%s%W%H$O=P$^$;$s!# - - - -(BFile: yahtmlj, Node: Reread CSS file, Prev: CSS-class completion, Up: CSS Support - -CSS$(BDj5A%U%!%$%k$NFI$_D>$7 -(B========================= -html$(B%U%!%$%k$rJT=8Cf$K(BCSS$(BDj5A%U%!%$%k$r=$@5$7!"DI2C$7$?(Bclass$(B$rJd408uJd$H$7 -$FD>$A$KFI$_9~$^$;$?$$>l9g$O!"(B`M-x yahtml-mode' $(B$H$7$F:F5/F0$r9T$C$F$/$@$5 -$$!# - - - -(BFile: yahtmlj, Node: Customizations, Next: Copying, Prev: CSS Support, Up: Top - -$(B%+%9%?%^%$%: -(B************ - -yahtml$(B$NF0:n$r@)8f$9$kJQ?t$K$D$$$F@bL@$7$^$9!# - -(B* Menu: - -* All customizable variables:: $(B%+%9%?%^%$%:JQ?t0lMw -(B* Hook variables:: hook$(BJQ?t - - - -(BFile: yahtmlj, Node: All customizable variables, Next: Hook variables, Prev: Customizations, Up: Customizations - -$(B%+%9%?%^%$%:JQ?t0lMw -(B==================== - - -- Variable: yahtml-prefix - yahtml-mode $(BCf$N%W%j%U%#%/%9%-!< (B(`\C-c') - - -- Variable: yahtml-image-viewer - img$(B$G;2>H$7$F$$$k2hA|%U%!%$%k$rI=<($9$k$H$-$K5/F0$9$k%3%^%s%I (B(xv) - - -- Variable: yahtml-www-browser - `[prefix]g' $(B$G30It%Z!<%8$rI=<($9$k$H$-$K5/F0$9$k%V%i%&%6 (B(netscape) - - -- Variable: yahtml-kanji-code - $(B%G%U%)%k%H$N4A;z%3!<%I!#(B1=sjis, 2=jis, 3=euc, 4=utf-8 (2) - .htaccess $(B%U%!%$%k$K - (BAddType "text/html; charset=xxx" .html $(B$N5-=R$,$"$C$?>l9g$O$=$l - $K=>$& - - (B-- Variable: yahtml-fill-column - auto-fill$(B$9$k$H$-$N%+%i%`?t (B(72) - - -- Variable: yahtml-fill-prefix - yahtml-mode $(B8GM-$N(Bfill-prefix (`nil') - - -- Variable: yahtml-path-url-alist - OS$(B$N%U%!%$%k%7%9%F%`>e$G$N%U%k%Q%9L>$H!"$=$N30It8x3+;~$N(BURL$(B$NBP1~I=!# - - (B-- Variable: yahtml-directory-index - $(B%5!<%P%"%/%;%9;~%U%!%$%kL>$r>JN,$7$?$H$-$K%G%U%)%k%H$G3+$+$l$k%$%s%G%C - %/%9%U%!%$%k$NL>A0!#B?$/$N>l9g (Bindex.html$(B!#(B(`"index.html"') - - -- Variable: yahtml-lint-program - HTML$(B9=J8%A%'%C%/%W%m%0%i%`!#(B(`"jweblint"') - - -- Variable: yahtml-hate-too-deep-indentation - $(B%M%9%H$7$?Ns5s7O4D6-$G$N%$%s%G%s%H$,?<$9$.$k$H$-$K(Bt$(B$K$9$k!#(B(`nil') - - -- Variable: yahtml-always-/p - `' $(B$r$$$l$?$iI,$: (B`' $(B$7$?$$?M8~$1!#(B`nil' - - -- Variable: yahtml-p-prefered-env-regexp - $(B<+F0E*$K (B`' $(B$rF~$l$FM_$7$$4D6-!# - (B(`"^\\(body\\|dl\\|blockquote\\)"') - - -- Variable: yahtml-template-file - $(B?75,(BHTML$(B%U%!%$%k:n@.;~$K<+F0E*$KA^F~$7$FM_$7$$%U%!%$%kL>!# - (B`"~/http/template.html"' - - -- Variable: yahtml-prefer-upcases - $(B%?%0$KBgJ8;z$r;H$$$?$$!#(B`nil' - - -- Variable: yahtml-prefer-upcase-attributes - $(BB0@-;XDj;R$KBgJ8;z$r;H$$$?$$!#(B`nil' - - -- Variable: yahtml-server-type - Apache$(B7O$N%5!<%P$rMxMQ$7$F$$$k>l9g$O (B'apache $(B$r%;%C%H$9$k!# - (B./.htaccess $(B$r;2>H$9$k$+$I$&$+$r7hDj$9$k!#(B`'apache' - - -- Variable: yahtml-apache-access-file - `yahtml-server-type' $(B$, (B`'apache' $(B$N$H$-$K%"%/%;%9@)8B%U%!%$%kL>$r;X - Dj!#(B`".htaccess"' - - -- Variable: yahtml-shell-command-option - $(B%7%'%k$GJL%3%^%s%I$r5/F0$9$k$H$-$N%*%W%7%g%s!# - - (B-- Variable: yahtml-translate-hyphens-when-comment-region - $(BNN0h%3%a%s%H%"%&%H$r$9$k$H$-$K4{$KB8:_$9$k%O%$%U%s$r (B`-' $(B$KJQ99$9 - $k$+$I$&$+!#(B(`t') - - -- Variable: yahtml-entity-reference-chars-alist - $(B%(%s%F%#%F%#;2>H(B(Entity Reference)$(B$G5-=R$9$Y$-J8;z72$r(B`'(?$(BJ8;z (B. "$(B%( - %s%F%#%F%#I=5-(B")' $(B$H$$$&7A<0$rNs5s$7$?(Balist$(B$GJB$Y$k!#%G%U%)%k%H$G - (B`<', `>', `&', `'', `"' $(B$KBP$9$k(Balist$(B$,@_Dj$5$l$F$$$k$N$G!"DI2C$7$?$$ - J,$@$1$r5-=R$9$l$PNI$$!#(Bcdr$(BIt (B`"$(B%(%s%F%#%F%#I=5-(B"' $(B$O!"@hF,$N (B`&' $(B$H - KvHx$N(B`;' $(B$O4^$a$:$K=q$/!# - - (B-- Variable: yahtml-faithful-to-htmllint - $(B9=J8%A%'%C%+$H$7$F (Bhtmllint $(B$rMxMQ$9$k>l9g$A$g$C$H$7$?M>7W$J6uGr$J$I - $KBP$7$F$b7Y9p$r<($9$N$G!"$3$l$r2sHr$9$k$H$-$K$O$3$NJQ?t$r(B`t'$(B$K$9$k!# - - (B-- Variable: yahtml-use-css - CSS$(B$NJd405!G=$r;H$&$+$I$&$+ (B(`t') - - -- Variable: yahtml-image-inspection-bytes - $(B2hA|%U%!%$%k$N%5%$%:$rD4$Y$k$H$-$KFI$_9~$`%P%$%H?t (B(`10000') - - -- Variable: yahtml:img-default-alt-format - $(B$N(BALT$(BB0@-$N%G%U%)%k%HJ8;zNs$N=q<0!#(B%x$(B$O2hA|$NI}!"(B%y$(B$O2hA| - $N9b$5!"(B%s$(B$O%U%!%$%k%5%$%:$KCV49$5$l$k (B(`"%xx%y(%sbytes)"') - - -- Variable: yahtml-escape-chars - href$(BJd40$J$I$N$H$-$KM=LsJ8;z$r(BURL$(B%(%s%3!<%I$9$k$+(B; 'ask$(B$N$H$-$O3NG'$7 - $F$+$iCV49$9$k (B(`'ask') - - -- Variable: yahtml-use-font-lock - $(B%=!<%9$N?'$E$1%Q%C%1!<%8$H$7$F (Bfont-lock $(B$rMxMQ$9$k$+(B(`(featurep - 'font-lock)') - - -- Variable: yahtml-use-hilit19 - $(B%=!<%9$N?'$E$1%Q%C%1!<%8$H$7$F (Bhilit19 $(B$rMxMQ$9$k$+(B(`(featurep - 'hilit19)') - - -- Variable: yahtml-indentation-boundary - $(B%$%s%G%s%H7W;;$rBG$A@Z$C$F$h$$6-3&$H$J$k@55,I=8=(B(`"^\\s *"') - - - -File: yahtmlj, Node: Hook variables, Prev: All customizable variables, Up: Customizations - -hook$(BJQ?t -(B======== - - - - -File: yahtmlj, Node: Copying, Next: Concept Index, Prev: Customizations, Up: Top - -$(B:\Ey$K4X$7$F$O@)8B$$$? -$7$^$;$s!#>o<1E*$K07$C$F$/$@$5$$!#$^$?!";HMQ$7$F$$$k;]$r%a%$%k$G$*CN$i$;$$ -$?$@$/$H!":np!"4uK>!"%P%0Js9p!"46A[Ey$O4?7^$$$?$7$^$9!#O"Mm$O (Byuuji@yatex.org $(B$^ -$G(B(2000$(BG/(B12$(B7n8=:_(B)$(B!#7QB3E*$K;HMQ$7$F$/$@$5$kJ}$O%a%$%j%s%0%j%9%H!V(Bfj$(BLnD;$N -2q!W$K@'Hs2CF~$7$F$/$@$5$$!#2CF~J}K!$K$D$$$F$OK\%Q%C%1!<%8$N (B`docs/htmlqa' -$(B%U%!%$%k$N!V$=$NB>!W$N>O$r8fMw$/$@$5$$!# - -;EMM$O!"M=9p$J$/3NH$X$NJQ99(B5300 -Node: $(B%j%8%g%sFbJ8;z$N(BURLencode5658 -Node: td$(B3g$j(B/tr$(B3g$j(B5890 -Node: CSS Support6519 -Node: CSS-class completion6738 -Node: Reread CSS file7734 -Node: Customizations7956 -Node: All customizable variables8180 -Node: Hook variables11178 -Node: Copying11290 -Node: Concept Index11793 - -End tag table +Info file: yahtmlj, -*-Text-*- +produced by `texinfo-format-buffer' +from file `yahtmlj.tex' +using `texinfmt.el' version 2.38 of 3 July 1998. + + + + + + +File: yahtmlj, Node: Top, Next: Intro, Prev: (dir), Up: (dir) + +* Menu: + +* Intro:: �͂��߂� +* Installation:: �C���X�g�[�� +* Command Invocation:: �O���R�}���h�N�� +* Completion:: �⊮���� +* Jump:: �J�[�\���W�����v +* Changing and Deleting:: �ύX�ƍ폜 +* CSS Support:: �X�^�C���V�[�g�⊮ +* Customizations:: �J�X�^�}�C�Y�ϐ��ꗗ +* Copying:: �Ƃ肠���� +* Concept Index:: ���� + + + + +File: yahtmlj, Node: Intro, Next: Installation, Prev: Top, Up: Top + +�͂��߂� +******** + +yahtml�� GNU Emacs ��� HTML�������쐬���鎞�ɁA�ɎG��HTML�^�O�̓��͂�⊮ +�@�\�ɂ���ăX���[�Y�ɍs����悤�ɂ��邾���łȂ��Aweblint�Ȃǂ̍\���`�F�b +�N�v���O�����A�J�[�\���ʒu��URL��t�@�C�����Ɉˑ������u���E�U/�C���[�W�����[ +�A�̋N���Ȃǂ� Emacs �ҏW��ʒ�����s����悤�ɂ���p�b�P�[�W�ł��B + +(����Info�͖������ł�(__)�c) + + + +File: yahtmlj, Node: Installation, Next: Command Invocation, Prev: Intro, Up: Top + +�C���X�g�[�� +************ +* Menu: + +* yahtml�N���̂��߂̐ݒ�:: +* lint�v���O����/�u���E�U/�C���[�W�����[�A�����̐ݒ�:: +* WWW�y�[�W���p�ϐ��̐ݒ�:: + + + +File: yahtmlj, Node: yahtml�N���̂��߂̐ݒ�, Next: lint�v���O����/�u���E�U/�C���[�W�����[�A�����̐ݒ�, Prev: Installation, Up: Installation + +yahtml�N���̂��߂̐ݒ� +====================== + + +`~/.emacs'�ɉ���2���ڂ������܂��B + + (setq auto-mode-alist + (cons (cons "\\.html$" 'yahtml-mode) auto-mode-alist)) + (autoload 'yahtml-mode "yahtml" "Yet Another HTML mode" t) + +����yahtml�ɕK�v�ȃt�@�C��(`yahtml.el', `yatexlib.el', `yatexprc.el') ��u +���f�B���N�g���� load-path �ɉ����܂��B���Ƃ��A `~/src/emacs/yahtml'�ɒu +���̂ł���A + + (setq load-path (cons (expand-file-name "~/src/emacs/yahtml") load-path)) + +�ȂǂƂ��܂��B + + �ȏ�̐ݒ�ɂ��A�g���q�� .html �ł���t�@�C����ҏW����Ǝ����I�� +yahtml �����[�h����܂��Byahtml������ɋN���ł����Ƃ��̓��[�h���C���̕\�� +���uyahtml�v�ɕς��܂��B + + + +File: yahtmlj, Node: lint�v���O����/�u���E�U/�C���[�W�����[�A�����̐ݒ�, Next: WWW�y�[�W���p�ϐ��̐ݒ�, Prev: yahtml�N���̂��߂̐ݒ�, Up: Installation + +lint�v���O����/�u���E�U/�C���[�W�����[�A�����̐ݒ� +==================================================== + +���p����O���v���O�����ȂǂɊւ���ȉ��̕ϐ����m�F���A�K�v�Ȃ琳�����l�ɕ� +�X���܂�(���ʓ��̓f�t�H���g�l)�B +`yahtml-www-browser' + ... �N������u���E�U�̃R�}���h��(netscape) +`yahtml-image-viewer' + ... �N������摜�r���[�A�̃R�}���h��(xv) +`yahtml-lint-program' + ... �\���`�F�b�N�v���O�����̃R�}���h��(jweblint) +`yahtml-kanji-code' + ... html�t�@�C���̊����R�[�h + + + +File: yahtmlj, Node: WWW�y�[�W���p�ϐ��̐ݒ�, Prev: lint�v���O����/�u���E�U/�C���[�W�����[�A�����̐ݒ�, Up: Installation + +WWW�y�[�W���p�ϐ��̐ݒ� +========================= + +�z�[���y�[�W�ƂȂ�t�@�C�������݂���PATH���Ɋւ���ϐ���ݒ肵�܂��B +`yahtml-path-url-alist' + ... �t�@�C���V�X�e�����PATH���ƁAURL�̑Ή��\ +`yahtml-directory-index' + ... URL�w��Ńt�@�C�������ȗ������Ƃ��ɕ\�������C���f�b�N�X + �t�@�C����(NCSA�nhttpd�Ȃ� `index.html', CERN�n�Ȃ�`Welcome.html'���� + �ʓI) + +�ϐ� `yahtml-path-url-alist' �̐ݒ��������܂��B�Ⴆ�A����ł́A +`/home/yuuji/http/' �� `http://localhost/~yuuji' �ŎQ�Ƃł��A�E��ł� +`/usr/home/yuuji/www/' ��`http://www.keio.ac.jp/~yuuji/' �ŎQ�Ƃł���悤 +�ɂȂ��Ă���ꍇ�͈ȉ��̂悤�ɐݒ肵�܂��B + + (setq yahtml-path-url-alist + '(("/home/yuuj/http" . "http://localhost/~yuuji") + ("/usr/home/yuuj/www" . "http://www.keio.ac.jp/~yuuji"))) + +���̑Ή��g�͂�����ł��ݒ肷�邱�Ƃ��ł��܂��B + + + +File: yahtmlj, Node: Command Invocation, Next: Completion, Prev: Installation, Up: Top + +�O���R�}���h�N�� +**************** + +HTML�t�@�C���ҏW�ɂ�����邢�����̃R�}���h���ɌĂԂ��Ƃ��ł��܂��B +`[prefix] t j' + ... HTML�\���`�F�b�J(jweblint)�N�� +`[prefix] t p' + ... ���݂̃y�[�W��ΏۂƂ����u���E�U�N�� +`[prefix] t r' + ... ���݂̃y�[�W���u���E�U�ɕ\������Ă���Ƃ���reload�w�� + + + +File: yahtmlj, Node: Completion, Next: Jump, Prev: Command Invocation, Up: Top + +�⊮���� +******** + +�u�쒹�v�ŗ��p�ł���A�ubegin�^�⊮�v�A�usection�^�⊮�v�A�ularge�^�⊮�v�A +�umaketitle�^�⊮�v�A�u�A�N�Z���g�⊮�v�ƑS�������L�[����őΉ�����HTML�^ +�O�̕⊮���͂��ł��܂��B���ꂼ��̌^�̕⊮�͏��ɁA�u�����s�ɓn��^�O���́v�A +�u��v�f�^�O(img�Ȃ�)�̕⊮�v�A�u��s���ł̊J�n/�I���^�O�̓��́v�A�u��v�f +���^�O�̓��́v�A�u�����Q�Ɠ��́v�ɑΉ����Ă��܂��B��̓I�ɂ� + +`[prefix] b (�쒹��begin�⊮�ɑΉ�)' + ... + + + + �̂悤�ɊJ�n�^�O�ƏI���^�O���s�ɓn���ď��������ꍇ�̕⊮���w���܂��B + �����Ƀu���b�N�^�^�O���⊮���Ɋ܂܂�܂��B + +`[prefix] s (�쒹��section�^�⊮�ɑΉ�)' + ... + + + �̂悤�ɏI���^�O���������A�������l�݂̂ŋ@�\���w�肷��^�O��⊮�� + �܂��B�⊮���Ƃ��ẮAimg, input �����݂��܂��B + +`[prefix] l (�쒹��large�^�⊮�ɑΉ�)' + ... begin�^�⊮�Ƃقړ����ł����A + + �` + + �̂悤�Ɉ�s���ɊJ�n/�I���^�O����ꂽ���Ƃ��ɗ��p���܂��B + +`[prefix] m (�쒹��maketitle�^�⊮�ɑΉ�)' + ... �v�f�������l�������Ȃ��^�O��⊮���͂��܂��B + �Ȃǂ��⊮���ɑ������܂��B + +`[prefix] a (�쒹�̃A�N�Z���g�⊮�ɑΉ�)' + ... �G���e�B�e�B�Q�Ƃɂ�镶���\�L����͂���Ƃ��ɗp���܂��B + �f�t�H���g�ł� < (<), > (>), & (&), " ("), ' ('), + �u�����N ( ) �̕⊮���͂��s���܂��B + + + +File: yahtmlj, Node: Jump, Next: Changing and Deleting, Prev: Completion, Up: Top + +�J�[�\���W�����v +**************** +�������̂��낢��ȏꏊ�� + +`[prefix] g' + ... �Ή�����I�u�W�F�N�g�ɃW�����v + +���������Ƃɂ��A�J�[�\���ʒu��HTML�\���ɑΉ�����ꏊ�ɃW�����v���܂��B�� +���W�����݂���Ɖ��߂����R�}���h�ɂ͈ȉ��̂��̂�����܂��B + + * `' ���� `' + * `' �� �Ή�����viewer�N�� + * `' �� �����N��ւ̃|�C���g�ړ� + * `' �� Java�\�[�X�v���O�����ւ̈ړ� + + + +File: yahtmlj, Node: Changing and Deleting, Next: CSS Support, Prev: Jump, Up: Top + +�ύX/�폜 +********* + +* Menu: + +* �^�O�̕ύX:: +* �����Q�Ƃւ̕ύX:: +* ���W������������URLencode:: +* td����/tr����:: + + + +File: yahtmlj, Node: �^�O�̕ύX, Next: �����Q�Ƃւ̕ύX, Prev: Changing and Deleting, Up: Changing and Deleting + +�^�O�̕ύX +============ +�������̂��낢��ȏꏊ�� + +`[prefix] c' + ... �Ή�����^�O����ύX + +���������Ƃɂ��A�J�[�\���ʒu��HTML�\���ɉ������L�q���e�̕ύX���s���܂��B +�J�[�\���ʒu�ƕύX������e�̑Ή��͈ȉ��̒ʂ�ł��B + + * `'�``' + ... `TAG' �̕ύX + * `' �Ȃǂ̑����l + ... �����l�̕ύX + + + +File: yahtmlj, Node: �����Q�Ƃւ̕ύX, Next: ���W������������URLencode, Prev: �^�O�̕ύX, Up: Changing and Deleting + +�����Q�Ƃւ̕ύX +================ +�����Ƃ��Ă� < �� > ��\������Ƃ��́A�����Q�Ƃ�p����< �� > �ƕ\�L +����K�v������܂����AHTML�ȊO�̃t�@�C�����炱���̕������܂ރe�L�X�g�� +�荞�ꍇ�ȂǂɁA�����̕������ꊇ���ĕ����Q�ƌ`���ɕϊ��ł��܂��B + +`[prefix] ;' + ... �w�肵���̈�̕����Q�Ƃɒu��������ׂ������̒u�� +`[prefix] :' + ... �w�肵���̈�̕����Q�Ƃ��Q�ƕ������̂��̂ɒu��([prefix] ; + �̋t�ϊ�) + + + + +File: yahtmlj, Node: ���W������������URLencode, Next: td����/tr����, Prev: �����Q�Ƃւ̕ύX, Up: Changing and Deleting + +���W������������URLencode +========================= + `[prefix] #' + + ... �w�肵���̈���� URLencode ���ׂ�����������������G�� + �R�[�h�\�L�ɒu���B + + + +File: yahtmlj, Node: td����/tr����, Prev: ���W������������URLencode, Up: Changing and Deleting + +td����/tr���� +============= +���ŏ������\�`���̍s���R�[�h�� ����̕��сC���邢�͂������� +��� �Ŋ������s���тɕϊ��ł��܂��B + `[prefix] }' + + ... ���݂̃��W�����ɂ���f�[�^����育�Ƃ� + ... �Ŋ��� + `[prefix] ]' + + ... ���݂̃��W�����ɂ���s����Ltd������قǂ����Ă��炳��ɍs���� +�� ... �Ŋ���f�t�H���g�ł͋��ł����C�����ς���Ƃ��� +Delimiter: �̖₢���킹�ɋ�蕶�����w�肵�܂��B���Ƃ��J���}(,) ���w�� +�����CSV����\����邱�Ƃ��ł��܂��B + +td�ȊO�̗v�f�C��̓I�ɂ� th �Ŋ��肽���ꍇ�� universal-argument (`C-u') �� +���ď�L2�̃R�}���h���Ăт܂��B�ǂ̗v�f�Ŋ��邩�̎��₪������̂ł��� +�� th �Ɠ����C�e�t�B�[���h�� ... �Ŋ���܂��B�����C��1�t�B�[ +���h�̂� th �ŁC�c���S�� td ����ɂ������Ƃ��� thd �Ɠ��͂��ĉ������B + + + +File: yahtmlj, Node: CSS Support, Next: Customizations, Prev: Changing and Deleting, Up: Top + +CSS(�X�^�C���V�[�g)�T�|�[�g +*************************** + +* Menu: + +* CSS-class completion:: +* Reread CSS file:: + + + +File: yahtmlj, Node: CSS-class completion, Next: Reread CSS file, Prev: CSS Support, Up: CSS Support + +CSS�N���X���⊮ +=============== +HTML����CSS(Cascading Style Sheets)�̃N���X����⊮���͂��邱�Ƃ��ł��܂��B +�X�^�C����`�Ƃ��� + + h1.foo, h2.foo { background-color: 0xffffff; } + h1.bar, h2.bar { font-size: 120%; } + +�̂悤�Ȃ��̂��������ꍇ�ɁAh1�܂���h2�^�O�� [prefix] b �� [prefix] l �ŕ� +�����͂����ꍇ�ɁA�����ɗL���� class ���ł��� foo, bar �����Ƃ��ĕ⊮ +���͂��邱�Ƃ��\�ł��B�܂� + + .caution { font-size: 120%; background-color: 0xc00000;} + +�̂悤�ȑS�ẴG�������g�ɓ���class����`����Ă����ꍇ�́A�S�Ẵ^�O�̕� +�����͎���class�Q�Ɠ��͂����߂��܂��B���ꂪ�ς킵���ꍇ�̓G�������g���� +�͊m��̂Ƃ��Ƀ��^�[���L�[(�܂���C-m)�ł͂Ȃ��AC-j��������class�⊮���͂� +�L�����Z���ł��܂��B���Ƃ��� + + [prefix] l �s���^�O�⊮���N�� + (�܂���[prefix] l SPC) + tt �����ꂽ���̂�tt�Ɠ��� + C-m + +�Ƃ����ꍇ�͑����� class= �ƕ⊮�v�����v�g���o�܂����A + + [prefix] l �s���^�O�⊮���N�� + (�܂���[prefix] l SPC) + tt �����ꂽ���̂�tt�Ɠ��� + C-j + +�ƍŌ�� `C-j' �œ��͂����ꍇ�� class �⊮�v�����v�g�͏o�܂���B + + + +File: yahtmlj, Node: Reread CSS file, Prev: CSS-class completion, Up: CSS Support + +CSS��`�t�@�C���̓ǂݒ��� +========================= +html�t�@�C����ҏW����CSS��`�t�@�C�����C�����A�lj�����class��⊮���Ƃ� +�Ē����ɓǂݍ��܂������ꍇ�́A`M-x yahtml-mode' �Ƃ��čċN�����s���Ă����� +���B + + + +File: yahtmlj, Node: Customizations, Next: Copying, Prev: CSS Support, Up: Top + +�J�X�^�}�C�Y +************ + +yahtml�̓���𐧌䂷��ϐ��ɂ��Đ������܂��B + +* Menu: + +* All customizable variables:: �J�X�^�}�C�Y�ϐ��ꗗ +* Hook variables:: hook�ϐ� + + + +File: yahtmlj, Node: All customizable variables, Next: Hook variables, Prev: Customizations, Up: Customizations + +�J�X�^�}�C�Y�ϐ��ꗗ +==================== + + -- Variable: yahtml-prefix + yahtml-mode ���̃v���t�B�N�X�L�[ (`\C-c') + + -- Variable: yahtml-image-viewer + img�ŎQ�Ƃ��Ă���摜�t�@�C����\������Ƃ��ɋN������R�}���h (xv) + + -- Variable: yahtml-www-browser + `[prefix]g' �ŊO���y�[�W��\������Ƃ��ɋN������u���E�U (netscape) + + -- Variable: yahtml-kanji-code + �f�t�H���g�̊����R�[�h�B1=sjis, 2=jis, 3=euc, 4=utf-8 (2) + .htaccess �t�@�C���� + AddType "text/html; charset=xxx" .html �̋L�q���������ꍇ�͂��� + �ɏ]�� + + -- Variable: yahtml-fill-column + auto-fill����Ƃ��̃J������ (72) + + -- Variable: yahtml-fill-prefix + yahtml-mode �ŗL��fill-prefix (`nil') + + -- Variable: yahtml-path-url-alist + OS�̃t�@�C���V�X�e����ł̃t���p�X���ƁA���̊O�����J����URL�̑Ή��\�B + + -- Variable: yahtml-directory-index + �T�[�o�A�N�Z�X���t�@�C�������ȗ������Ƃ��Ƀf�t�H���g�ŊJ�����C���f�b + �N�X�t�@�C���̖��O�B�����̏ꍇ index.html�B(`"index.html"') + + -- Variable: yahtml-lint-program + HTML�\���`�F�b�N�v���O�����B(`"jweblint"') + + -- Variable: yahtml-hate-too-deep-indentation + �l�X�g�����n���ł̃C���f���g���[������Ƃ���t�ɂ���B(`nil') + + -- Variable: yahtml-always-/p + `' �����ꂽ��K�� `' �������l�����B`nil' + + -- Variable: yahtml-p-prefered-env-regexp + �����I�� `' �����ė~�������B + (`"^\\(body\\|dl\\|blockquote\\)"') + + -- Variable: yahtml-template-file + �V�KHTML�t�@�C���쐬���Ɏ����I�ɑ}�����ė~�����t�@�C�����B + `"~/http/template.html"' + + -- Variable: yahtml-prefer-upcases + �^�O�ɑ啶�����g�������B`nil' + + -- Variable: yahtml-prefer-upcase-attributes + �����w��q�ɑ啶�����g�������B`nil' + + -- Variable: yahtml-server-type + Apache�n�̃T�[�o�𗘗p���Ă���ꍇ�� 'apache ���Z�b�g����B + ./.htaccess ���Q�Ƃ��邩�ǂ��������肷��B`'apache' + + -- Variable: yahtml-apache-access-file + `yahtml-server-type' �� `'apache' �̂Ƃ��ɃA�N�Z�X�����t�@�C�������w + ��B`".htaccess"' + + -- Variable: yahtml-shell-command-option + �V�F���ŕʃR�}���h���N������Ƃ��̃I�v�V�����B + + -- Variable: yahtml-translate-hyphens-when-comment-region + �̈�R�����g�A�E�g������Ƃ��Ɋ��ɑ��݂���n�C�t���� `-' �ɕύX�� + �邩�ǂ����B(`t') + + -- Variable: yahtml-entity-reference-chars-alist + �G���e�B�e�B�Q��(Entity Reference)�ŋL�q���ׂ������Q��`'(?���� . "�G + ���e�B�e�B�\�L")' �Ƃ����`�������alist�ŕ��ׂ�B�f�t�H���g�� + `<', `>', `&', `'', `"' �ɑ���alist���ݒ肳��Ă���̂ŁA�lj������� + ���������L�q����Ηǂ��Bcdr�� `"�G���e�B�e�B�\�L"' �́A�擪�� `&' �� + ������`;' �͊܂߂��ɏ����B + + -- Variable: yahtml-faithful-to-htmllint + �\���`�F�b�J�Ƃ��� htmllint �𗘗p����ꍇ������Ƃ����]�v�ȋȂ� + �ɑ��Ă��x���������̂ŁA������������Ƃ��ɂ͂��̕ϐ���`t'�ɂ���B + + -- Variable: yahtml-use-css + CSS�̕⊮�@�\���g�����ǂ��� (`t') + + -- Variable: yahtml-image-inspection-bytes + �摜�t�@�C���̃T�C�Y�ׂ�Ƃ��ɓǂݍ��ރo�C�g�� (`10000') + + -- Variable: yahtml:img-default-alt-format + ��ALT�����̃f�t�H���g������̏����B%x�͉摜�̕��A%y�͉摜 + �̍����A%s�̓t�@�C���T�C�Y�ɒu������� (`"%xx%y(%sbytes)"') + + -- Variable: yahtml-escape-chars + href�⊮�Ȃǂ̂Ƃ��ɗ\����URL�G���R�[�h���邩; 'ask�̂Ƃ��͊m�F�� + �Ă���u������ (`'ask') + + -- Variable: yahtml-use-font-lock + �\�[�X�̐F�Â��p�b�P�[�W�Ƃ��� font-lock �𗘗p���邩(`(featurep + 'font-lock)') + + -- Variable: yahtml-use-hilit19 + �\�[�X�̐F�Â��p�b�P�[�W�Ƃ��� hilit19 �𗘗p���邩(`(featurep + 'hilit19)') + + -- Variable: yahtml-indentation-boundary + �C���f���g�v�Z��ł����Ă悢���E�ƂȂ鐳�K�\��(`"^\\s *"') + + + +File: yahtmlj, Node: Hook variables, Prev: All customizable variables, Up: Customizations + +hook�ϐ� +======== + + + + +File: yahtmlj, Node: Copying, Next: Concept Index, Prev: Customizations, Up: Top + +��舵�� +******** + + �{�v���O�����̓t���[�\�t�g�E�F�A�ł��B�{�v���O�������g�p���Đ����������� +�錋�ʂɑ��Ă���҂͐ӔC��Ȃ����ƂƂ��܂��B�]�ړ��Ɋւ��Ă͐������� +���܂���B�펯�I�Ɉ����Ă��������B�܂��A�g�p���Ă���|�����C���ł��m�点�� +�������ƁA��҂͊��ŃT�|�[�g�ɗ�ނ��Ƃł��傤�B + + ���A��]�A�o�O�A���z���͊��}�������܂��B�A���� yuuji@yatex.org �� +��(2000�N12������)�B�p���I�Ɏg�p���Ă���������̓��C�����O���X�g�ufj�쒹�� +��v�ɐ���������Ă��������B�������@�ɂ��Ă͖{�p�b�P�[�W�� `docs/htmlqa' +�t�@�C���́u���̑��v�̏͂��䗗���������B + +�d�l�́A�\���Ȃ��m����(�C�������)�ύX����܂�:-p�B + + �L���Y�� + + + + +File: yahtmlj, Node: Concept Index, Prev: Copying, Up: Top + +���� +**** + +* Menu: + +* �J�X�^�}�C�Y[�������܂���]: Customizations. 4. +* �L�[�A�T�C��[������������]: Customizations. 4. +* Demacs: Intro. 4. +* HTML��[HTML��]: Intro. 4. +* LaTeX: Intro. 4. +* Mule: Intro. 4. + + + + +Tag table: +Node: Top151 +Node: Intro620 +Node: Installation899 +Node: yahtml�N���̂��߂̐ݒ�1087 +Node: lint�v���O����/�u���E�U/�C���[�W�����[�A�����̐ݒ�1741 +Node: WWW�y�[�W���p�ϐ��̐ݒ�2241 +Node: Command Invocation3012 +Node: Completion3339 +Node: Jump4323 +Node: Changing and Deleting4722 +Node: �^�O�̕ύX4896 +Node: �����Q�Ƃւ̕ύX5246 +Node: ���W������������URLencode5629 +Node: td����/tr����5863 +Node: CSS Support6492 +Node: CSS-class completion6690 +Node: Reread CSS file7674 +Node: Customizations7896 +Node: All customizable variables8120 +Node: Hook variables11118 +Node: Copying11230 +Node: Concept Index11733 + +End tag table diff --git a/docs/yahtmlj.tex b/docs/yahtmlj.tex index e53ddef..a82e8c0 100644 --- a/docs/yahtmlj.tex +++ b/docs/yahtmlj.tex @@ -5,7 +5,7 @@ @iftex @c @syncodeindex fn cp -@c Last modified Wed Feb 29 09:18:14 2012 on firestorm +@c Last modified Thu May 10 11:13:11 2012 on firestorm @syncodeindex vr cp @end iftex @@ -15,7 +15,7 @@ @subtitle Yet Another html-mode for emacs @title �wHTML���x @subtitle // yahtml // -@author @copyright{} 1994-1997 by HIROSE, Yuuji [yuuji@@yatex.org] +@author @copyright{} 1994-2012 by HIROSE, Yuuji [yuuji@@yatex.org] @end titlepage @node Top, Intro, (dir), (dir) diff --git a/docs/yatexe b/docs/yatexe index 9d700e5..302390c 100644 --- a/docs/yatexe +++ b/docs/yatexe @@ -1,2219 +1,2242 @@ -Info file: yatexe, -*-Text-*- -produced by `texinfo-format-buffer' -from file `yatexe.tex' -using `texinfmt.el' version 2.38 of 3 July 1998. - - - - - - -File: yatexe, Node: Top, Next: What is YaTeX?, Prev: (dir), Up: (dir) - -* Menu: - -* What is YaTeX?:: -* Main features:: What YaTeX can do -* Installation:: Guide to install -* Typesetting:: Call typesetting processes -* %#notation:: Meta-keyword `%#' -* Completion:: Input LaTeX commands with completion -* Local dictionaries:: Directory dependent completion -* Commenting out:: Commenting/uncommenting text -* Cursor jump:: Jumping to related position -* Changing and Deleting:: Changing/deleting certain unit of text -* Filling:: Filling an item or paragraph -* Updation of includeonly:: Free from maintaining includeonly -* What column:: Check what table-column the cursor belong -* Intelligent newline:: Guess requisites of new line -* Usepackage checker:: Selecting correct \usepackage is YaTeX's job -* Online help:: On-line documentation of LaTeX -* Browsing file hierarchy:: Walking through file hierarchy -* Cooperation with other packages:: Work well with gmhist, min-out -* Customizations:: How to breed `Wild Bird' -* Etcetera:: YaTeX is acquisitive. -* Copying:: Redistribution - - - - -File: yatexe, Node: What is YaTeX?, Next: Main features, Prev: Top, Up: Top - -What is YaTeX? -************** - - YaTeX automates typesetting and previewing of LaTeX and enables -completing input of LaTeX mark-up command such as -`\begin{}'..`\end{}'. - - YaTeX also supports Demacs which runs on MS-DOS(386), Mule (Multi -Language Enhancement to GNU Emacs), and latex on DOS. - - - -File: yatexe, Node: Main features, Next: Installation, Prev: What is YaTeX?, Up: Top - -Main features -************* - - * Invocation of typesetter, previewer and related programs(`C-c t') - * Typesetting on static region which is independent from point - * Semiautomatic replacing of `\includeonly' - * Jumping to error line(`C-c '') - * Completing-read of LaTeX commands such as `\begin{}', - `\section' etc. - (`C-c b', `C-c s', `C-c l', `C-c m') - * Enclosing text into LaTeX environments or commands - (`C-u' ABOVEKEYSTROKES) - * Displaying the structure of text at entering sectioning commands - * Lump shifting of sectioning commands (*Note view-sectioning::) - * Learning unknown/new LaTeX commands for the next completion - * Argument reading with a guide for complicated LaTeX commands - * Generating argument-readers for new/unsupported commands(`yatexgen') - * Quick changing or deleting of LaTeX commands(`C-c c', `C-c k') - * Jumping from and to inter-file, begin<->end, ref<->label(`C-c g') - * Blanket commenting out or uncommenting - (`C-c >', `C-c <', `C-c ,', `C-c .') - * Easy input of accent mark, math-mode's commands and Greek letters - (`C-c a', `;', `:') - * Online help for the popular LaTeX commands - (`C-c ?', `C-c /') - * Document files hierarchy browser (`C-c d') - * Adding automatically \usepackage corresponding to inputting LaTeX - macro with completion - * Allow you to forget creating \label{}s, \ref or \cite completion - automatically generate labels. - - - -File: yatexe, Node: Installation, Next: Typesetting, Prev: Main features, Up: Top - -Installation -************ - - Put next two expressions into your `~/.emacs'. - - (setq auto-mode-alist - (cons (cons "\\.tex$" 'yatex-mode) auto-mode-alist)) - (autoload 'yatex-mode "yatex" "Yet Another LaTeX mode" t) - -Next, add certain path name where you put files of YaTeX to your -load-path. If you want to put them in `~/src/emacs', write - - (setq load-path - (cons (expand-file-name "~/src/emacs") load-path)) - -in your `~/.emacs' - - Then, yatex-mode will be automatically loaded when you visit a -file which has extension `.tex'. If yatex-mode is successfully -loaded, mode string on mode line will be turned to "YaTeX". - - - - -File: yatexe, Node: Typesetting, Next: %#notation, Prev: Installation, Up: Top - -Typesetting -*********** - - The prefix key stroke of yatex-mode is `C-c' (Press 'C' with Control -key) by default. If you don't intend to change the prefix key stroke, -assume all `[prefix]' as `C-c' in this document. These key -strokes execute typeset or preview command. - -`[prefix] t j' - ... invoke latex -`[prefix] t r' - ... invoke latex on region -`[prefix] t e' - ... invoke latex on current environment or whole - portion of current formulas in math-mode. -`[prefix] t k' - ... kill current typesetting process -`[prefix] t b' - ... invoke bibtex -`[prefix] t i' - ... invoke makeindex -`[prefix] t d' - ... invoke latex && dvipdfmx -`[prefix] t p' - ... preview -`[prefix] t l' - ... lpr dvi-file -`[prefix] t s' - ... search current string on xdvi-remote - -* Menu: - -* Calling typesetter:: -* Calling previewer:: -* Printing out:: - - - -File: yatexe, Node: Calling typesetter, Next: Calling previewer, Prev: Typesetting, Up: Typesetting - -Calling typesetter -================== - - Typing `[prefix] t j', the current editing window will be divided -horizontally when you invoke latex command, and log message of LaTeX -typesetting will be displayed in the other window; called typesetting -buffer. The typesetting buffer automatically scrolls up and traces LaTeX -warnings and error messages. If you see latex stopping by an error, you -can send string to latex in the typesetting buffer. - - If an error stops the LaTeX typesetting, this key stroke will move the -cursor to the line where LaTeX error is detected. - -`[prefix] '' -`([prefix]+single quotation)' - - ... jump to the previous error or warning - - If you find a noticeable error, move to the typesetting buffer and move -the cursor on the line of error message and type `SPACE' key. This makes -the cursor move to corresponding source line. - - YaTeX-typeset-region invoked by `[prefix] tr' call typesetter for -region. The region is specified by standard point and mark, or by -`%#BEGIN' and `%#END' marks. Selected region will be copied to the -temporary file `texput.tex' with the same preamble as the main file of -current editing sources. Be sure to put all local macro settings in -preamble, not after `\begin{document}'. The method of specification of -the region is shown in the section *Note %#notation::. - - The documentclass for typeset-region is the same as that of editing file -if you edit one file, and is the same as main file's if you edit splitting -files. - - The `[prefix] te' key automatically marks current inner environment or -inner math mode and then call typeset-region with marked region. This is -convenient to quick view of current tabular environment or current editing -formulas. Keeping previewer window for `texput.dvi' is handy for -debugging. Since `[prefix] te' selects the inner-most environment as -region, it is not suitable for partial typesetting of doubly or more -composed environment. If you want to do partial typesetting for a nested -environment, use `[prefix] tr' for static-region, which is described in -the section *Note %#notation::. - - - -File: yatexe, Node: Calling previewer, Next: Printing out, Prev: Calling typesetter, Up: Typesetting - -Calling previewer -================= - - `[prefix] t p' invokes the TeX previewer. And if you are using -xdvi-remote, which can be controled from other terminals, `[prefix] t s' -enables you to search current string at the cursor on the running xdvi -window. - - - -File: yatexe, Node: Printing out, Prev: Calling previewer, Up: Typesetting - -Printing out -============ - - When you type `[preifx] t l', YaTeX asks you the range of dvi-printing -by default. You can skip this by invoking it with universal-argument as -follows: - - C-u [prefix] tl - - - -File: yatexe, Node: %#notation, Next: Completion, Prev: Typesetting, Up: Top - -%# notation -*********** - - You can control the typesetting process by describing `%#' notations in -the source text. - -* Menu: - -* Changing typesetter:: -* Splitting input files:: -* Static region for typesetting:: -* Lpr format:: -* Editing %# notation:: - - - -File: yatexe, Node: Changing typesetter, Next: Splitting input files, Prev: %#notation, Up: %#notation - -To change the `latex' command or to split a source text. -======================================================== - - To change the typesetting command, write - - %#!latex-big - -anywhere in the source text. This is useful for changing typesetter. - - - -File: yatexe, Node: Splitting input files, Next: Static region for typesetting, Prev: Changing typesetter, Up: %#notation - -Splitting input files -===================== - - And if you split the source text and edit subfile that should be -included from main text. - - %#!latex main.tex - -will be helpful to execute latex on main file from sub text buffer. Since -this command line after `%#!' will be sent to shell literally, next -description makes it convenient to use ghostview as dvi-previewer. - - %#!latex main ; dvi2ps main.dvi > main - -Note that YaTeX assumes the component before the last period of the last -word in this line as base name of the main LaTeX source. The `%f' -notation in this line is replaced by main file name, and `%r' replaced by -root name of main file name. If you specify `%f' or `%r', YaTeX always -ask you the name of main file at the first typesetting. - - To make best use of the feature of inter-file jumping by `[prefix] g' -(see *Note Cursor jump::), take described below into consideration. - - * You can put split texts in sub directory, but not in sub directory of - sub directory. - * In the main text, specify the child file name with relative path name - such as \include{chap1/sub}, when you include the file in a - sub-directory. - * In a sub-text, write `%#!latex main.tex' even if `main.tex' is in the - parent directory(not %#!latex ../main.tex). - - - -File: yatexe, Node: Static region for typesetting, Next: Lpr format, Prev: Splitting input files, Up: %#notation - -Static region -============= - - Typeset-region by `[prefix] tr' passes the region between point and mark -to typesetting command by default. But when you want to typeset static -region, enclose the region by `%#BEGIN' and `%#END' as follows. - - %#BEGIN - TheRegionYouWantToTypesetManyTimes - %#END - -This is the rule of deciding the region. - - 1. If there exists %#BEGIN before point, - - 1. If there exists %#END after %#BEGIN, - * From %#BEGIN to %#END. - - 2. If %#END does not exist after %#BEGIN, - * From %#BEGIN to the end of buffer. - - 2. If there does not exist %#BEGIN before point, - * Between point and mark(standard method of Emacs). - - It is useful to write `%#BEGIN' in the previous line of \begin and -`%#END' in the next line of \`end' when you try complex environment such -as `tabular' many times. It is also useful to put only `%#BEGIN' alone at -the middle of very long text. Do not forget to erase `%#BEGIN' `%#END' -pair. - - - -File: yatexe, Node: Lpr format, Next: Editing %# notation, Prev: Static region for typesetting, Up: %#notation - -Lpr format -========== - - Lpr format is specified by three Lisp variables. Here are the default -values of them. - -`(1)dviprint-command-format' - `"dvi2ps %f %t %s | lpr"' -`(2)dviprint-from-format' - `"-f %b"' -`(3)dviprint-to-format' - `"-t %e"' - - On YaTeX-lpr, `%s' in (1) is replaced by the file name of main text, -`%f' by contents of (2), %t by contents of (3). At these replacements, -`%b' in (2) is also replaced by the number of beginning page, `%e' in (3) -is replaced by the number of ending page. But `%f' and `%t' are ignored -when you omit the range of print-out by `C-u [prefix] tl'. - - If you want to change this lpr format temporarily, put a command such as -follows somewhere in the text: - - %#LPR dvi2ps %f %t %s | 4up -page 4 | texfix | lpr -Plp2 - - And if you want YaTeX not to ask you the range of printing out, the next -example may be helpful. - - %#LPR dvi2ps %s | lpr - - - -File: yatexe, Node: Editing %# notation, Prev: Lpr format, Up: %#notation - -Editing %# notation -=================== - - To edit `%#' notation described above, type - -`[prefix] %' - ... editing %# notation menu - -and select one of the entry of the menu as follows. - - !)Edit-%#! B)EGIN-END-region L)Edit-%#LPR - -Type `!' to edit `%#!' entry, `b' to enclose the region with `%#BEGIN' and -`%#END', and `l' to edit `%#LPR' entry. When you type `b', all `%#BEGIN' -and `%#END' are automatically erased. - - - -File: yatexe, Node: Completion, Next: Local dictionaries, Prev: %#notation, Up: Top - -Completion -********** - - YaTeX makes it easy to input the LaTeX commands. There are several -kinds of completion type, begin-type, section-type, large-type, etc... - -* Menu: - -* Begin-type completion:: -* Section-type completion:: -* Large-type completion:: -* Maketitle-type completion:: -* Arbitrary completion:: -* End completion:: -* Accent completion:: -* Image completion:: -* Greek letters completion:: - - - -File: yatexe, Node: Begin-type completion, Next: Section-type completion, Prev: Completion, Up: Completion - -Begin-type completion -===================== - - "Begin-type completion" completes commands of `\begin{env}' ... -`\end{env}'. All of the begin-type completions begin with this key -sequence. - -`[prefix] b' - ... start begin-type completion - -An additional key stroke immediately completes a frequently used LaTeX -`\begin{}'...`\`end'{}' environment. - -`[prefix] b c' - ... `\begin{center}...\end{center}' -`[prefix] b d' - ... `\begin{document}...\end{document}' -`[prefix] b D' - ... `\begin{description}...\end{description}' -`[prefix] b e' - ... `\begin{enumerate}...\end{enumerate}' -`[prefix] b E' - ... `\begin{equation}...\end{equation}' -`[prefix] b i' - ... `\begin{itemize}...\end{itemize}' -`[prefix] b l' - ... `\begin{flushleft}...\end{flushleft}' -`[prefix] b m' - ... `\begin{minipage}...\end{minipage}' -`[prefix] b t' - ... `\begin{tabbing}...\end{tabbing}' -`[prefix] b T' - ... `\begin{tabular}...\end{tabular}' -`[prefix] b^T' - ... `\begin{table}...\end{table}' -`[prefix] b p' - ... `\begin{picture}...\end{picture}' -`[prefix] b q' - ... `\begin{quote}...\end{quote}' -`[prefix] b Q' - ... `\begin{quotation}...\end{quotation}' -`[prefix] b r' - ... `\begin{flushright}...\end{flushright}' -`[prefix] b v' - ... `\begin{verbatim}...\end{verbatim}' -`[prefix] b V' - ... `\begin{verse}...\end{verse}' - - Any other LaTeX environments are made by completing-read of the Emacs -function. - -`[prefix] b SPACE' - ... begin-type completion - -The next message will show up in the minibuffer - - Begin environment(default document): - -by typing `[prefix] b'. Put the wishing environment with completion in -the minibuffer, and `\begin{env}'...\`\end{env}' will be inserted in the -LaTeX source text. If the environment you want to put does not exist in -the YaTeX completion table, it will be registered in the user completion -table. YaTeX automatically saves the user completion table in the user -dictionary file at exiting of emacs. - -At the completion of certain environments, the expected initial entry will -automatically inserted such as `\item' for `itemize' environment. If you -don't want the entry, it can be removed by undoing. - - If you want to enclose some paragraphs which have already been written, -invoke the begin-type completion with changing the case of `b' of key -sequence upper(or invoke it with universal argument by `C-u' prefix). - - The following example encloses a region with `description' environment. - -`[prefix] B D' -`(or ESC 1 [prefix] b D)' -`(or C-u [prefix] b D)' - - ... begin-type completion for region - - This enclosing holds good for the completing input by `[prefix] b SPC'. -`[prefix] B SPC' enclose a region with the environment selected by -completing-read. - - - -File: yatexe, Node: Section-type completion, Next: Large-type completion, Prev: Begin-type completion, Up: Completion - -Section-type completion -======================= - - "Section-type completion" completes section-type commands which take an -argument or more such as `\section{foo}'. To invoke section-type -completion, type - -`[prefix] s' - ... section-type completion - -then the prompt - - (C-v for view) \???{} (default documentclass): - -will show up in the minibuffer. Section-type LaTeX commands are completed -by space key, and the default value is selected when you type nothing in -the minibuffer. - - Next, - - \section{???}: - -prompts you the argument of section-type LaTeX command. For example, the -following inputs - - \???{} (default documentclass): section - \section{???}: Hello world. - -will insert the string - - \section{Hello world.} - -in your LaTeX source. When you neglect argument such as - - (C-v for view) \???{} (default section): vspace* - \vspace*{???}: - -YaTeX puts - - \vspace*{} - -and move the cursor in the braces. - - In LaTeX command, there are commands which take more than one arguments -such as `\addtolength{\topmargin}{8mm}'. To complete these commands, -invoke section-type completion with universal argument as, - - C-u 2 [prefix] s (or ESC 2 [prefix] s) - -and make answers in minibuffer like this. - - (C-v for view) \???{} (default vspace*): addtolength - \addtolength{???}: \topmargin - Argument 2: 8mm - -`\addtolength' and the first argument `\topmargin' can be typed easily by -completing read. Since YaTeX also learns the number of arguments of -section-type command and will ask that many arguments in future -completion, you had better tell the number of arguments to YaTeX at the -first completion of the new word. But you can change the number of -arguments by calling the completion with different universal argument -again. - - - Invoking section-type completion with `[Prefix] S' (Capital `S') -includes the region as the first argument of section-type command. - - The section/large/maketitle type completion can work at the prompt for -the argument of other section-type completion. Nested LaTeX commands are -efficiently read with the recursive completion by typing YaTeX's -completion key sequence in the minibuffer. - -* Menu: - -* view-sectioning:: - - - -File: yatexe, Node: view-sectioning, Prev: Section-type completion, Up: Section-type completion - -view-sectioning ---------------- - - In the minibuffer at the prompt of section-type command completion, -typing `C-v' shows a list of sectioning commands in source text(The line -with `<<--' mark is the nearest sectioning command). Then, default -sectioning command appears in the minibuffer. You can go up/down -sectioning command by typing `C-p'/`C-n', can scrolls up/down the listing -buffer by `C-v'/`M-v', and can hide sectioning commands under certain -level by 0 through 6. Type `?' in the minibuffer of sectioning prompt -for more information. - - You can generate this listing buffer (`*Sectioning Lines*' buffer) by -typing -`M-x YaTeX-section-overview' - ... Generate *Sectioning Lines* buffer - -from the LaTeX source buffer. In this listing buffer, typing `u' on the -sectioning command shifts up the corresponding sectioning command in -source text and `d' shifts down. After marking lines in the listing -buffer, typing `U' shifts up all sectioning commands in the region, and -`U' shifts down. Here are all the key bindings of `*Sectioning Lines*' -buffer. - -`SPC' - ... Jump to corresponding source line -`.' - ... Display corresponding source line -`u' - ... Shift up a sectioning line -`d' - ... Shift down a sectioning line -`U' - ... Shift up sectioning lines in region -`D' - ... Shift down sectioning lines in region -`0...6' - ... Hide sectioning commands whose level is lower than n - - - - -File: yatexe, Node: Large-type completion, Next: Maketitle-type completion, Prev: Section-type completion, Up: Completion - -Large-type completion -===================== - - "Large-type completion" inputs the font or size changing descriptions -such as `{\large }'. When you type - -`[prefix] l' - ... large-type completion - -the message in the minibuffer - - {\??? } (default large): - -prompts prompts you large-type command with completing-read. There are -TeX commands to change fonts or sizes, `it', `huge' and so on, in the -completion table. - - Region-based completion is also invoked by changing the letter after -prefix key stroke as `[prefix] L'. It encloses the region by braces with -large-type command. - - - -File: yatexe, Node: Maketitle-type completion, Next: Arbitrary completion, Prev: Large-type completion, Up: Completion - -Maketitle-type completion -========================= - - We call it "maketitle-type completion" which completes commands such as -`\maketitle'. Take notice that maketitle-type commands take no arguments. -Then, typing - -`[prefix] m' - ... maketitle-type completion - -begins maketitle-completion. Above mentioned method is true for -maketitle-completion, and there are LaTeX commands with no arguments in -completion table. - - - -File: yatexe, Node: Arbitrary completion, Next: End completion, Prev: Maketitle-type completion, Up: Completion - -Arbitrary completion -==================== - - You can complete certain LaTeX command anywhere without typical -completing method as described, by typing - -`[prefix] SPC' - ... arbitrary completion - -after the initial string of LaTeX command that is preceded by `\'. - - - -File: yatexe, Node: End completion, Next: Accent completion, Prev: Arbitrary completion, Up: Completion - -End completion -============== - - YaTeX automatically detects the opened environment and close it with -\`\end{environment}'. Though proficient YaTeX users never fail to make -environment with begin-type completion, some may begin an environment -manually. In that case, type - -`[prefix] e' - ... `end' completion - -at the end of the opened environment. - - - -File: yatexe, Node: Accent completion, Next: Image completion, Prev: End completion, Up: Completion - -Accent completion -================= - - When you want to write the European accent marks(like `\`{o}'), - -`[prefix] a' - ... accent completion - -shows the menu - - 1:` 2:' 3:^ 4:" 5:~ 6:= 7:. u v H t c d b - -in the minibuffer. Chose one character or corresponding numeric, and you -will see - - \`{} - -in the editing buffer with the cursor positioned in braces. Type one more -character `o' for example, then - - \`{o} - -will be completed, and the cursor gets out from braces. - - - -File: yatexe, Node: Image completion, Next: Greek letters completion, Prev: Accent completion, Up: Completion - -Image completion of mathematical sign -===================================== - - Arrow marks, sigma mark and those signs mainly used in the TeX's math -environment are completed by key sequences which imitate the corresponding -symbols graphically. This completion only works in the math environment. -YaTeX automatically detects whether the cursor located in math environment -or not, and change the behavior of key strokes `;' and `:'. - - By the way, we often express the leftarrow mark by `<-' for example. -Considering such image, you can write `\leftarrow' by typing `<-' after -`;' (semicolon) as a prefix. In the same way, `\longleftarrow' (`<--') is -completed by typing `;<--', infinity mark which is imitated by `oo' is -completed by typing `;oo'. - - Here are the sample operations in YaTeX math-mode. - - INPUT Completed LaTeX commands - ; < - `\leftarrow' - ; < - - `\longleftarrow' - ; < - - > `\longleftrightarrow' - ; o `\circ' - ; o o `\infty' - - In any case, you can quit from image completion and can move to the next -editing operation if the LaTeX command you want is shown in the buffer. - - `;' itself in math-environment is inserted by `;;'. Typing `TAB' in the -midst of image completion shows all of the LaTeX commands that start with -the same name as string you previously typed in. In this menu buffer, -press `RET' after moving the cursor (by `n', `p', `b', `f') to insert the -LaTeX command. - - To know all of the completion table, type `TAB' just after `;'. And -here is the sample menu by `TAB' after `;<'. - - KEY LaTeX sequence sign - < \leq < - ~ - << \ll << - <- \leftarrow <- - <= \Leftarrow <= - - You can define your favorite key-vs-sequence completion table in the -Emacs-Lisp variable `YaTeX-math-sign-alist-private'. See also -`yatexmth.el' for the information of the structure of this variable. - - - -File: yatexe, Node: Greek letters completion, Prev: Image completion, Up: Completion - -Greek letters completion -======================== - - Math-mode of YaTeX provides another image completion, Greek letters -completion in the same method. After prefix `:', typing `a' makes -`\alpha', `b' makes `\beta' and `g' makes `\gamma' and so on. First, type -`:TAB' to know all the correspondence of alphabets vs. Greek letters. - - If you will find `;' or `:' doesn't work in correct position of math -environment, it may be a bug of YaTeX. Please send me a bug report with -the configuration of your text, and avoid it temporarily by typing `;' or -`:' after universal-argument(`C-u') which forces `;' and `:' to work as -math-prefix. - - - -File: yatexe, Node: Local dictionaries, Next: Commenting out, Prev: Completion, Up: Top - -Local dictionaries -****************** - - Tables for completion consist of three dictionaries; `standard -dictionary' built in `yatex.el', `user dictionary' for your common private -commands, and `local dictionary' that is effective in a certain directory. - - When you input the command unknown to YaTeX at a completion in the -minibuffer, YaTeX asks you with the following prompt; - - `foo' is not in table. Register into: U)serDic L)ocalDic N)one D)iscard - -In this menu, typing `u' updates your `user dictionary', `l' updates your -local dictionary, `n' updates only on-memory dictionary which go through -only current Emacs session, and `d' updates no dictionary and throws the -new word away. - - If you find this switching feature meaningless and bothersome, put the -next expression into your `~/.emacs' - - (setq YaTeX-nervous nil) - - - -File: yatexe, Node: Commenting out, Next: Cursor jump, Prev: Local dictionaries, Up: Top - -Commenting out -************** - - You may want to comment out some region. - -`[prefix] >' - ... comment out region by % -`[prefix] <' - ... uncomment region - -cause an operation to the region between point and mark. - -`[prefix] .' - ... comment out current paragraph -`[prefix] ,' - ... uncomment current paragraph - -comments or uncomments the paragraph where the cursor belongs. This -`paragraph' means the region marked by the function mark-paragraph, bound -to `ESC h' by default. It is NOT predictable what will happen when you -continuously comment out some paragraph many times. - - You can also comment out an environment between `\begin' and `\end', or -a `\begin'-\`\end' pair themselves, by making the following key strokes on -the line where `\begin{}' or `\end{}' exists. - -`[prefix] >' - ... comment out from \begin to \`end' -`[prefix] <' - ... uncomment from \begin to \`end' - -comment whole the contents of environment. Moreover, - -`[prefix] .' - ... comment out \begin and \`end' -`[prefix] ,' - ... uncomment \begin and \`end' - -(un)comments out only environment declaration: `\begin{}' and `\end{}'. -NOTE that even if you intend to comment out some region, invoking -`[prefix] >' on the `\begin',`\end' line decides to work in `commenting -out from `\begin' to `\end'' mode. - - - - -File: yatexe, Node: Cursor jump, Next: Changing and Deleting, Prev: Commenting out, Up: Top - -Cursor jump -*********** - - -* Menu: - -* Jump to corresponding object:: -* Invoking image processor:: -* Jump to main file:: -* Jumping around the environment:: -* Jumping to last completion position:: - - - -File: yatexe, Node: Jump to corresponding object, Next: Invoking image processor, Prev: Cursor jump, Up: Cursor jump - -Jump to corresponding object -============================ - - Typing - -`[prefix] g' - ... go to corresponding object - -in a certain place move the cursor to the place corresponding to the LaTeX -command of last place. YaTeX recognize the followings as pairs that have -relation each other. - - * `\begin{}' <-> `\end{}' - * `%#BEGIN' <-> `%#END' - * On the image-including line -> corresponding viewer or drawing tool - * `\label{}' <-> `\ref{}' - * `\include(\input)' -> included file - * `\bibitem{}' <-> `\cite{}' - - On a `\begin',`\end' line, typing `[prefix] g' moves the cursor to the -corresponding `\end',`\begin' line, if its partner really exists. The -behavior on the line `%#BEGIN' and `%#END' are the same. Note that if the -correspondent of `label/ref' or `cite/bibitem' exists in another file, -that file have to be opened to make a round trip between references by -`[prefix] g'. - - If you type `[prefix] g' on the line of `\include{chap1}', typically in -the main text, YaTeX switches buffer to `chap1.tex'. - -`[prefix] 4 g' - ... go to corresponding object in other window - -do the same job as `[prefix] g' except it's done in other window. Note -that this function doesn't work on `begin/end', `%#BEGIN/%#END' pairs -because it is meaningless. - - - -File: yatexe, Node: Invoking image processor, Next: Jump to main file, Prev: Jump to corresponding object, Up: Cursor jump - -Invoking image processor -======================== - - -`image-including line' described above means such lines as -`\epsfile{file=foo.ps}'. If you type `[prefix] g' on that line, YaTeX -automatically searches source of `foo.ps' and invokes image viewer or -drawing tool correspoinding to it. For example; if you draw an image -foo.obj with Tgif and enclose its product named foo.eps by `\epsfile' -command. Typing `[prefix] g' on `\epsfile' line make YaTeX invoke `tgif -foo.obj'. How a processor is choosen is as follows. - - 1. If there is an expression matching with one of the pattern defined in - `YaTeX-processed-file-regexp-alist', extract file name from regexp - group surrounded by \\(\\). (Which group corresponds is written in - the cdr part of each list.) If no matches were found, do nothing. - 2. If there is a pattern as `%PROCESSOR' which is defined in the - variable `YaTeX-file-processor-alist', call that processor giving the - file name with corresponding extension. - 3. If not, check the existence of each file which is supplied the - extension in the cdr part of each list of - `YaTeX-file-processor-alist'. If any, call the corresponding image - viewer or drawing tool. - - - -File: yatexe, Node: Jump to main file, Next: Jumping around the environment, Prev: Invoking image processor, Up: Cursor jump - -Jump to main file -================= - - Typing - -`[prefix] ^' - ... visit main file -`[prefix] 4^' - ... visit main file in other buffer - -in a sub text switch the buffer to the main text specified by `%#!' -notation. - - - -File: yatexe, Node: Jumping around the environment, Next: Jumping to last completion position, Prev: Jump to main file, Up: Cursor jump - -Jumping around the environment -============================== - - And these are the functions which work on the current LaTeX environment: - -`M-C-a' - ... beginning of environment -`M-C-e' - ... `end' of environment -`M-C-@' - ... mark environment - - - -File: yatexe, Node: Jumping to last completion position, Prev: Jumping around the environment, Up: Cursor jump - -Jumping to last completion position -=================================== - -YaTeX always memorize the position of completion into register `3'. So -every time you make a trip to any other part of text other than you are -writing, you can return to the editing paragraph by calling -register-to-point with argument YaTeX-current-position-register, which is -achieved by typing `C-x j 3'(by default). - - - -File: yatexe, Node: Changing and Deleting, Next: Filling, Prev: Cursor jump, Up: Top - -Changing and Deleting -********************* - - These functions are for change or deletion of LaTeX commands already -entered. - -`[prefix] c' - ... change LaTeX command -`[prefix] k' - ... kill LaTeX command - -* Menu: - -* Changing LaTeX commands:: -* Killing LaTeX commands:: - - - -File: yatexe, Node: Changing LaTeX commands, Next: Killing LaTeX commands, Prev: Changing and Deleting, Up: Changing and Deleting - -Changing LaTeX commands -======================= - -`[prefix] c' can change the various (La)TeX commands. This can change the -followings. - * Environment names - * Section-type commands - * Argument of section-type commands - * Optional parameters (enclosed by []) of section-type commands - * Font/size designators - * Math-mode's maketitle-type commands that can be inputted with image - completion - - Typing `[prefix] c' on one of above objects you want to change brings a -suitable reading function sometimes with completion. Note: If you want to -change the argument of section-type command that contains other LaTeX -commands, type `[prefix] c' either of surrounding braces of the argument -in order to make YaTeX ignore the internal LaTeX sequences as an object of -changing. Anyway, it is very difficult to know which argument position -the cursor belongs because the LaTeX commands can be nested and braces can -freely emerge. So keep it mind to put the cursor on a brace when you are -thinking of changing a complicated argument. - - - -File: yatexe, Node: Killing LaTeX commands, Prev: Changing LaTeX commands, Up: Changing and Deleting - -Killing LaTeX commands -====================== - - `[prefix] k' kills the LaTeX commands sometimes with their arguments. -Following table illustrates the correspondence of the invoking position -and what is killed. - - [Invoking position] [action] - \begin, \end line kill \begin,\end pairs - %#BEGIN, %#END line kill %#BEGIN,%#END pairs - on a Section-type command kill section-type command - on a parenthesis kill parentheses - -Note that when killing `\begin, \end' or `%#BEGIN, %#END' pair, the lines -`\begin, \end' or `%#BEGIN, %#END' exist will be killed entirely. So take -care not to create any line that contains more than one `\begin' or so. - -While all operations above are to kill `containers' which surround some -text, universal argument (`C-u') for these commands kills not only -`containers' but also `contents' of them. See below as a sample. - - Original text: [prefix] k C-u [prefix] k - Main \footnote{note} here. Main note here. Main here. - ~(cursor) - - - -File: yatexe, Node: Filling, Next: Updation of includeonly, Prev: Changing and Deleting, Up: Top - -Filling -******* - - -Filling an item -=============== - - To fill a term (descriptive sentences) of `\item', type - -`M-q' - ... fill item - -on that item. - - YaTeX uses the value of the variable `YaTeX-item-regexp' as the regular -expression to search item header in itemize environment. If you make a -newcommand to itemize terms(e.g. `\underlineitem'), put - - (setq YaTeX-item-regexp - "\\(\\\\\\(sub\\)*item\\)\\|\\(\\\\underlineitem\\)") - -in your `~/.emacs'. If you are not familiar with regular expression for -Emacs-Lisp, name a newcommand for `itemize' beginning with `\item' such as -`\itembf', not `\bfitem'. - - This function reformats the `\item' into `hang-indented' style. For -example: - - itemize, enumerate environment: - > - >\item[foo] `foo' is the typical word for describing an - > arbitrarily written.... - description environment: - > \item[bar] When the word `for' is used as an arbitrarily - > word, `bar' is bound to follow it. - - Note that the indent depth of an `\item' word and its descriptive -paragraph are the same in latter case. If you want to use different -depth, invoke fill-paragraph at the beginning of non-whitespace -character(see below). - - -Filling paragraph -================= - - Fill-paragraph is little bit adapted for LaTeX sources. It retains from -filling in certain environments where formatting leads to a disaster such -as verbatim, tabular, or so. And it protects `\verb' expressions from -being folded (The variable `YaTeX-verb-regexp' controls this). Besides, -putting cursor on the first occurrence of non-whitespace character on a -line changes the fill-prefix temporarily to the depth of the line. - - - -File: yatexe, Node: Updation of includeonly, Next: What column, Prev: Filling, Up: Top - -Updation of `\includeonly' -************************** - - When you edit splitting source texts, the notation - - \includeonly{CurrentEditingFileName} - -in the main file reduces the time of typesetting. If you want to hack -other file a little however, you have to rewrite it to - - \includeonly{OtherFileNameYouWantToFix} - -in the main file. YaTeX automatically detects that the current edited -text is not in includeonly list and prompts you - - A)dd R)eplace %)comment? - -in the minibuffer. Type `a' if you want to add the current file name to -`\includeonly' list, `r' to replace \`includeonly' list with the current -file, and type `%' to comment out the `\includeonly' line. - - - -File: yatexe, Node: What column, Next: Intelligent newline, Prev: Updation of includeonly, Up: Top - -What column? -************ - - We are often get tired of finding the corresponding column in large -tabulars. For example, - - \begin{tabular}{|c|c|c|c|c|c|c|c|}\hline - Name&Position&Post No.&Addr.&Phone No.&FAX No.& - Home Addr.&Home Phone\\ \hline - Thunder Bird & 6 & 223 & LA & xxx-yyy & - zzz-www & Japan & 9876-54321 \\ - & 2 & \multicolumn{2}{c|}{Unknown} - &&&(???) - \\ \hline - \end{tabular} - -Suppose you have the cursor located at `(???)' mark, can you tell which -column it is belonging at once? Maybe no. In such case, type - -`[prefix] &' - ... What column - -in that position. YaTeX tells you the column header of the current field. -Since YaTeX assumes the first line of tabular environment as a row of -column headers, you can create a row of virtual column headers by putting -them in the first line and commenting that line with `%'. - - - -File: yatexe, Node: Intelligent newline, Next: Usepackage checker, Prev: What column, Up: Top - -Intelligent newline -******************* - - At the end of begin-type completion of tabular[*], array, itemize, -enumerate or tabbing environment, or typing - -`ESC RET' - ... Intelligent newline - -in these environments inserts the contents corresponding to the current -environment in the next line. (At the begin-type completion, this -contents can be removed by `undo'.) In `tabular' environment, for -example, `ESC RET' inserts the certain number of `&' and trailing `\\', -and `\hline' if other `\hline' is found in backward. Here are the list of -contents vs. environments. - - * `tabular', `tabular*', `array' - - Corresponding number of `&' and `\\'. And `\hline' if - needed. - - * `tabbing' - - The same number of `\>' as `\=' in the first line. - - * `itemize', `enumerate', `description', `list' - - `\item' or `item[]'. - - Note that since this function works seeing the contents of the first -line, please call this after the second line if possible. - - If you want to apply these trick to other environments, `foo' -environment for example, define the function named -`YaTeX-intelligent-newline-foo' to insert corresponding contents. That -function will be called at the beginning of the next line after the -newline is inserted to the current line. Since the function -`YaTeX-indent-line' is designed to indent the current line properly, -calling this function before your code to insert certain contents must be -useful. See the definition of the function -`YaTeX-intelligent-newline-itemize' as an example. - - - -File: yatexe, Node: Usepackage checker, Next: Online help, Prev: Intelligent newline, Up: Top - -Usepackage checker -****************** - -When you input begint-type, section-type, maketitle-type macros with -completion, and it requires some LaTeX2e package, YaTeX examines the -existence of correct `\usepackage'. If not, YaTeX inserts the -`\usepackage{}' declaration corresponding to input macro. - -To activate the package completion for your favarite package, set the -variable `YaTeX-package-alist-private' correctly. Please refere the value -of `YaTeX-package-alist-default' as an example. - - - -File: yatexe, Node: Online help, Next: Browsing file hierarchy, Prev: Usepackage checker, Up: Top - -Online help -*********** - - YaTeX provides you the online help with popular LaTeX commands. - - Here are the key strokes for the online help. - -`[prefix] ?' - ... Online help -`[prefix] /' - ... Online apropos - - -Online help -=========== - - `Online help' shows the documentation for the popular LaTeX -commands(defaults to the commands on the cursor) in the next buffer. -There are two help file, `global help' and `private help'. The former -file contains the descriptions on the standard LaTeX command and is -specified its name by variable `YaTeX-help-file'. Usually, the global -help file should be located in public space (`$EMACSEXECPATH' by default) -and should be world writable so that anyone can update it to enrich its -contents. The latter file contains descriptions on non-standard or -personal command definitions and is specified by -`YaTeX-help-file-private'. This file should be put into private -directory. - - -Online apropos -============== - - `Online apropos' is an equivalent of GNU Emacs's apropos. It shows all -the documentations that contains the keyword entered by the user. - - -When no descriptions are found... -================================= - - If there is no description on a command in help files, YaTeX requires -you to write a description on that command. If you are willing to do, -determine which help file to add and write the description on it referring -your manual of (La)TeX. Please send me your additional descriptions if -you describe the help on some standard commands. I might want to include -it in the next distribution. - - - -File: yatexe, Node: Browsing file hierarchy, Next: Cooperation with other packages, Prev: Online help, Up: Top - -Browsing file hierarchy -*********************** - - When you are editing multi-file source, typing - -`[prefix] d' - ... browse file hierarchy - -asks you the parent-most file (which may be defaulted) and displays the -documentation hierarchy in the next window. In this buffer, the following -commands are available. - -`n' - ... move to the next line and show its contents -`p' - ... move to the previous line and show its contents -`N' - ... move to the next file in the same inclusion level -`P' - ... move to the previous file in the same inclusion level -`j' - ... move to the next line -`k' - ... move to the previous line -`u' - ... move to the parent file -`.' - ... show the current files contents in the next window -`SPC' - ... scroll up the current file window -`DEL, b' - ... scroll down the current file window -`<' - ... show the beginning of the current file -`>' - ... show the end of the current file -`>' - ... return to the previous postion after `<' or `>' -`RET, g' - ... open the current file in the next window -`mouse-2' - ... same as RET(available only with window system) -`o' - ... other window -`1' - ... delete other windows -`-' - ... shrink hierarchy buffer window -`+' - ... enlarge hierarchy buffer window -`?' - ... describe mode -`q' - ... quit - - Note that operations on the file contents in the next window do not work -correctly when you close the corresponding file. - - - -File: yatexe, Node: Cooperation with other packages, Next: Customizations, Prev: Browsing file hierarchy, Up: Top - -Cooperation with other packages -******************************* - - YaTeX works better with other brilliant packages. - - -gmhist -====== - - When you are loading `gmhist.el' and `gmhist-mh.el', you can use -independent command history list at the prompt of preview command -(`[prefix] tp') and print command (`[prefix] tl'). On each prompt, you -can enter the previous command line string repeatedly by typing `M-p'. - - -min-out -======= - - `min-out', the outline minor mode, can be used in yatex-mode buffers. -If you want to use it with YaTeX, please refer the file `yatexm-o.el' as -an example. - - - -File: yatexe, Node: Customizations, Next: Etcetera, Prev: Cooperation with other packages, Up: Top - -Customizations -************** - - You can customize YaTeX by setting Emacs-Lisp variables and by making -add-in functions. - -* Menu: - -* Lisp variables:: -* Add-in functions:: -* Add-in generator:: - - - -File: yatexe, Node: Lisp variables, Next: Add-in functions, Prev: Customizations, Up: Customizations - -Lisp variables -============== - - You can change the key assignments or make completion more comfortable -by setting the values of various variables which control the movement of -yatex-mode. - - For example, if you want to change the prefix key stroke from `C-c' to -any other sequence, set YaTeX-prefix to whatever you want to use. If you -don't want to use the key sequence `C-c letter' which is assumed to be the -user reserved sequence in Emacs world, set `YaTeX-inhibit-prefix-letter' -to `t', and all of the default key bind of `C-c letter' will turn to the -corresponding `C-c C-letter' (but the region based completions that is -invoked with `C-c Capital-letter' remain valid, if you want to disable -those bindings, set that variable to 1 instead of `t'). - -* Menu: - -* All customizable variables:: -* Sample definitions:: -* Hook variables:: -* Hook file:: - - - -File: yatexe, Node: All customizable variables, Next: Sample definitions, Prev: Lisp variables, Up: Lisp variables - -All customizable variables --------------------------- - - Here are the customizable variables of yatex-mode. Each value setq-ed -in `~/.emacs' is preferred and that of defined in `yatex.el' is neglected. -Parenthesized contents stands for the default value. When you are to -change some of these variables, see more detailed documentation of the -variable by `M-x describe-variable'. - - -- Variable: YaTeX-japan - Set this nil to produce all messages in English (`Depends on Japanese - feature of Emacs') - - -- Variable: YaTeX-kanji-code - Default buffer-file-coding-system for YaTeX modes' buffer. Set this - 0 to no language conversion. Nil to preserve original - coding-system. 1=Shift JIS, 2=JIS, 3=EUC, 4=UTF-8 (`1 or 2') - - -- Variable: YaTeX-prefix - Prefix key stroke (`C-c') - - -- Variable: YaTeX-inhibit-prefix-letter - Change key stroke from `C-c letter' to `C-c C-letter' (`nil') - - -- Variable: YaTeX-fill-prefix - Fill-prefix used in yatex-mode (`nil') - - -- Variable: YaTeX-user-completion-table - Name of user dictionary where learned completion table will be - stored. (`"~/.yatexrc"') - - -- Variable: tex-command - LaTeX typesetter command (`"latex"') - - -- Variable: dvi2-command - Preview command (`"xdvi -geo +0+0 -s 4"') - - -- Variable: dviprint-command-format - Command format to print dvi file (`"dvi2ps %f %t %s | lpr"') - - -- Variable: dviprint-from-format - Start page format of above %f. %b will turn to start page (`"-f %b"') - - -- Variable: dviprint-to-format - End page format of above %t. %e will turn to `end' page (`"-t %e"') - - -- Variable: makeindex-command - Default makeindex command (`"makeindex"' (`"makeind"' on MS-DOS)) - - -- Variable: YaTeX-dvipdf-command - Default command name to convert .dvi to PDF (`"dvipdfmx"') - - -- Variable: YaTeX-need-nonstop - Put `\nonstopmode{}' or not (`nil') - - -- Variable: latex-warning-regexp - Regular expression of warning message latex command puts out - (`"line.* [0-9]*"') - - -- Variable: latex-error-regexp - Regular expression of error message (`"l\\.[1-9][0-9]*"') - - -- Variable: latex-dos-emergency-message - Message latex command running on DOS puts at abort (`"Emergency - stop"') - - -- Variable: YaTeX-item-regexp - Regular expression of item command (`"\\\\item"') - - -- Variable: YaTeX-verb-regexp - Regexp of verb family. Omit \\\\. (`"verb\\*?\\|path"') - - -- Variable: YaTeX-nervous - T for using local dictionary (`t') - - -- Variable: YaTeX-sectioning-regexp - Regexp of LaTeX sectioning command - (`"\\(part\\|chapter\\*?\\|\\(sub\\)*\\(section\\|paragraph\\)\\*?\\)\\b"') - - -- Variable: YaTeX-fill-inhibit-environments - Inhibit fill in these environments (`'("tabular" "tabular*" "array" - "picture" "eqnarray" "eqnarray*" "equation" "math" "displaymath" - "verbatim" "verbatim*")') - - -- Variable: YaTeX-uncomment-once - T for deleting all preceding `%' (`nil') - - -- Variable: YaTeX-close-paren-always - T for always close all parenthesis automatically, `nil' for only eol - (`t') - - -- Variable: YaTeX-auto-math-mode - Switch math-mode automatically (`t') - - -- Variable: YaTeX-math-key-list-private - User defined alist, math-mode-prefix vs completion alist used in - image completion (`nil'). See `yatexmth.el' for the information - about how to define a completion alist. - - -- Variable: YaTeX-default-pop-window-height - Initial height of typesetting buffer when one-window. Number for the - lines of the buffer, numerical string for the percentage of the - screen-height. `nil' for half height (10) - - -- Variable: YaTeX-help-file - Global online help file name - (`$doc-directory/../../site-lisp/YATEXHLP.eng') - - -- Variable: YaTeX-help-file-private - Private online help file name (`"~/YATEXHLP.eng"') - - -- Variable: YaTeX-no-begend-shortcut - Disable [prefix] b ?? shortcut (`nil)' - - -- Variable: YaTeX-hilit-pattern-adjustment-private - List of the list that contain the regular expression and the symbol - of logical meaning of the string that matches the pattern. See also - the value from `(assq 'yatex-mode hilit-patterns-alist)' and the - value of `YaTeX-hilit-pattern-adjustment-default' (and even the - document of hilit19.el). - - -- Variable: YaTeX-sectioning-level - Alist of LaTeX's sectioning command vs its height. - - -- Variable: YaTeX-hierarchy-ignore-heading-regexp - `YaTeX-display-hierarchy' searches for sectioning command first, and - comment line secondary as a file headings. In latter case, ignore lines - that match with regular expression of this variable. Default value of - this variable is RCS header expressions and mode specifying line `-*- xxxx - -*'. - - -- Variable: YaTeX-skip-default-reader - Non-nil for this variable skips the default argument reader of - section-type command when add-in function for it is not defined - (`nil') - - -- Variable: YaTeX-create-file-prefix-g - When typing `prefix g' on the `\include' line, open the target file - even if the file doesn't exist (`nil') - - -- Variable: YaTeX-simple-messages - Simplyfy messages of various completions (`nil') - - -- Variable: YaTeX-hilit-sectioning-face - When hilit19 and yatex19 is active, YaTeX colors the sectioning - commands. This variable specifies the foreground and background - color of `\part' macro. The default value is `'(yellow/dodgerblue - yellow/slateblue)'. The first element of this list is for the screen - when `hilit-background-mode' is `'light', and the second element is - for `'dark'. You should specify both color as `forecolor/backcolor'. - - -- Variable: YaTeX-hilit-sectioning-attenuation-rate - When color mode, this variable specifies how much attenuate the color - density of `\subparagraph' compared with that of `\chapter' (`'(15 - 40)') See also `YaTeX-hilit-sectioning-face'. - - -- Variable: YaTeX-use-AMS-LaTeX - If you use AMS-LaTeX, set to `t' (`nil') - - -- Variable: YaTeX-use-LaTeX2e - If you use LaTeX2e, set to `t' (`t') - - -- Variable: YaTeX-template-file - File name which is automatically inserted at creation - (`~/work/template.tex') - - -- Variable: YaTeX-search-file-from-top-directory - Non-nil means to search input-files from the directory where main - file exists (`t') - - -- Variable: YaTeX-use-font-lock - Use font-lock to fontify buffer or not (`(featurep 'font-lock)' - - -- Variable: YaTeX-use-hilit19 - Use hilit19 to highlight buffer or not (`(featurep 'hilit19)' - - -- Variable: YaTeX-use-italic-bold - YaTeX tries to search italic, bold fontsets or not (`t' if Emacs-20 - or later). This variable is effective only when font-lock is used. - (`(featurep 'hilit19)' - - -- Variable: YaTeX-singlecmd-suffix - Suffix which is always inserted after maketitle-type macros. `"{}"' - is recommended. - - -- Variable: YaTeX-package-alist-private - Alist of LaTeX2e-package name vs. lists of macros in it. Set this - alist properly and YaTeX automatically check the declaratiion of - `usepackage' for corresponding macro, when you input that macro with - completion. If required `usepackage' is not found, YaTeX also - automatically inserts `\usepackage'. Alist is as follows; - '((PackageName1 (completionType ListOfMacro) (completionType - ListOfMacro)) (PackageName2 (completionType ListOfMacro) - (completionType ListOfMacro...))....) completionType is one of `env, - section, maketitle'. Consult the value of - `YaTeX-package-alist-default' as an example. - - -- Variable: YaTeX-tabular-indentation - At indentation by `C-i' in tabular or array environment, YaTeX put - the additional spaces to the normail indentation depth. The number - of additional spaces is the product of YaTeX-tabular-indentation and - the number of column position in tabular. - - -- Variable: YaTeX-noindent-env-regexp - Regexp of environment names that should begin with no indentation. - All verbatime-like environment name should match with. - - -- Variable: YaTeX-ref-default-label-string - Default \\ref time string format. This format is like strftime(3) - but allowed conversion char are as follows; %y -> Last 2 digit of - year, %b -> Month name, %m -> Monthe number(1-12), %d -> Day, %H -> - Hour, %M -> Minute, %S -> Second, %qx -> alphabetical-decimal - conversion of yymmdd. %qX -> alphabetical-decimal conversion of - HHMMSS. Beware defualt label-string should be always unique. So - this format string should have both time part (%H+%M+%S or %qX) and - date part (%y+(%b|%m)+%d or %qx). - - -- Variable: YaTeX-ref-generate-label-function - Function to generate default label string for unnamed \\label{}s. - The function pointed to this value should take two arguments. First - argument is LaTeX macro's name, second is macro's argument. Here is - an example for using this value. - (setq YaTeX-ref-generate-label-function 'my-yatex-generate-label) - (defun my-yatex-generate-label (command value) - (and (string= command "caption") - (re-search-backward "\\\\begin{\\(figure\\|table\\)}" nil t) - (setq command (match-string 1))) - (let ((alist '(("chapter" . "chap") - ("section" . "sec") - ("subsection" . "subsec") - ("figure" . "fig") - ("table" . "tbl")))) - (if (setq command (cdr (assoc command alist))) - (concat command ":" value) - (YaTeX::ref-generate-label nil nil)))) - - - - -File: yatexe, Node: Sample definitions, Next: Hook variables, Prev: All customizable variables, Up: Lisp variables - -Sample definitions ------------------- - - For instance, to change the prefix key stroke to `ESC', and name of the -user dictionary `~/src/emacs/yatexrc', and set `fill-prefix' to single TAB -character, add the following `setq' to `~/.emacs'. - - (setq YaTeX-prefix "\e" - YaTeX-user-completion-table "~/src/emacs/yatexrc" - YaTeX-fill-prefix " ") - - - -File: yatexe, Node: Hook variables, Next: Hook file, Prev: Sample definitions, Up: Lisp variables - -Hook variables --------------- - - More customizations will be done by the hook-function defined in -hook-variable `yatex-mode-hook'. This is useful to define a shortcut key -sequence to enter some environments other than `document' and `enumerate' -etc. The following statement defines `[prefix] ba' to enter -`\begin{abstract}' ... `=end{abstract}' immediately. - - (setq yatex-mode-hook - '(lambda() (YaTeX-define-begend-key "ba" "abstract"))) - - You should use functions `YaTeX-define-key', or -`YaTeX-define-begend-key' to define all the key sequences of yatex-mode. - - - -File: yatexe, Node: Hook file, Prev: Hook variables, Up: Lisp variables - -Hook file ---------- - - You can stuff all of YaTeX related expressions into a file named -`yatexhks.el' if you have a lot of codes. YaTeX automatically load this -file at the initialization of itself. Using `yatexhks.el' makes -`yatex-mode-load-hook' unnecessary. - - - -File: yatexe, Node: Add-in functions, Next: Add-in generator, Prev: Lisp variables, Up: Customizations - -Add-in functions -================ - - You can easily define a function to input detailed arguments with -completion according to LaTeX environments or commands. - - -What is add-in functions? -------------------------- - - When you input `tabular' environment, don't you think "I want YaTeX to -complete its argument toward my favorite one such as `{|c|c|c|}'..."? -Yes, you can define the function to complete arguments for any environment -and any LaTeX commands. - - -Procedure ---------- - - Here is the procedure to define add-in functions. - 1. Define the function - 2. Put the function into `yatexhks.el' - -* Menu: - -* How the add-in function works:: -* How the function is called:: -* Useful functions for creating add-in:: -* Contribution:: - - - -File: yatexe, Node: How the add-in function works, Next: How the function is called, Prev: Add-in functions, Up: Add-in functions - -How the add-in function works ------------------------------ - -There are three types of add-in. - - 1. Option add-in - 2. argument add-in - 3. enclosing add-in - -"Option add-in" returns the LaTeX's optional parameters such as optional -strings after `\begin{ENV}', optional strings between a section-type -command and its first argument, and optional strings just after type -maketitle-type command. The following illustrates the name of add-in -functions, where underlined strings are generated by add-in functions. - - \begin{table}[ht] (Function name: YaTeX:table) - ~~~~ - \put(100,200){} (Function name: YaTeX:put) - ~~~~~~~~~ - \sum_{i=0}^{n} (Function name: YaTeX:sum) - ~~~~~~~~~~ - - Obviously, the function name is decided by concatenating the prefix -`YaTeX:' and LaTeX command's name. - - Another add-in type is "argument add-in", which completes arguments for -section-type commands. - - \newcommand{\foo}{bar} (Function name: YaTeX::newcommand) - ~~~~ ~~~ - - When the section-type command is inputted, the function named by -concatenating `YaTeX::' and section-type command, is called automatically -with an integer argument which indicates which argument of section-type -command is being read. Thus the add-in should determine the job referring -the value of its argument. - - "enclosing add-in" is for modifying and/or checking the region that will -be enclosed by section-type commands via `[prefix] S'. An enclosing -add-in function will be called with two arguments, beginning of the -enclosed region and end of the region. Suppose you want to enclose the -existing text `(a+b)/c' by `\frac{}'. - - a/c - | | - A B - -You do set-mark-command at point A and then move to point B. Typing -`[prefix] S' and input `frac' enclose the region like this; - - \frac{a/c} - -Normally, the expression `a/c' is translated to `\frac{a}{c}'. An -enclosing add-in is useful for modifying `/' to `}{'. - -* Menu: - -* Defining option-add-in:: -* Defining argument-add-in:: -* Defining enclosing-add-in:: - - - -File: yatexe, Node: Defining option-add-in, Next: Defining argument-add-in, Prev: How the add-in function works, Up: How the add-in function works - -Defining `option add-in' -........................ - - If you want `{|c|c|c|}' for all `tabular' environment, - - (defun YaTeX:tabular () - "{|c|c|c|}") - -is enough. If you want more complicated format, define as below. - - (defun YaTeX:tabular () - "{@{\\vrule width 1pt\\ }|||@{\\ \\vrule width 1pt}}") - -Note that the character `\' must be described as `\\' in Emacs-Lisp. The -next example reads the tabular format from keyboard. - (defun YaTeX:tabular () - (concat "{" (read-string "Rule: ") "}")) - - - -File: yatexe, Node: Defining argument-add-in, Next: Defining enclosing-add-in, Prev: Defining option-add-in, Up: How the add-in function works - -Defining `argument add-in' -.......................... - - This section describes how to define the add-in function for -`\newcommand'. - - The first argument of `\newcommand' begins always with `\'. The second -argument is usually so complex that we can not edit them in the -minibuffer. Here is the created function considering this. - - (defun YaTeX::newcommand (n) ;n is argument position - (cond - ((= n 1) ;1st argument is macro name - (read-string "Command: " "\\")) ;initial input `\' - ((= n 2) "") ;do nothing when reading arg#2 - (t nil))) - - Note that when the `argument add-in' function return `nil', normal -argument reader will be called. - - - -File: yatexe, Node: Defining enclosing-add-in, Prev: Defining argument-add-in, Up: How the add-in function works - -Defining `enclosing add-in' -........................... - - This section describes how to define the add-in function for text -enclosed by `\frac{}'. - - When enclosing the text `5/3' by `\frac{}', you might want to replace -`/' with `}{'. Enclosing function `YaTeX::frac-region' is called with two -arguments, beginning of enclosed text and end of enclosed text. The -function is expected to replace `/' with `}{'. Here is an example -expression. - - (defun YaTeX::frac-region (beg end) - (catch 'done - (while (search-forward "/" end t) - (goto-char (match-beginning 0)) - (if (y-or-n-p "Replace this slash(/) with `}{'") - (throw 'done (replace-match "}{"))) - (goto-char (match-end 0))))) - - - -File: yatexe, Node: How the function is called, Next: Useful functions for creating add-in, Prev: How the add-in function works, Up: Add-in functions - -How the function is called --------------------------- - - YaTeX calls the add-in functions for specified begin-type, section-type, -and maketitle-type command, if any. `Option add-in' functions for -begin-type are called when `\begin{ENV}' has been inserted, functions for -section-type are called just before input of the first argument, and -functions for maketitle-type is called after maketitle-type command has -been inserted. `Argument add-in' functions are called at each entry of -arguments for section-type commands. - - - -File: yatexe, Node: Useful functions for creating add-in, Next: Contribution, Prev: How the function is called, Up: Add-in functions - -Useful functions for creating add-in ------------------------------------- - - Many add-in functions for typical LaTeX commands are defined in -`yatexadd.el'. Those are also useful as references. Here are the short -descriptions on useful functions, where [F] means function, [A] means -arguments, [D] means description. - -`[F]' - YaTeX:read-position -`[A]' - Character list which can show up in the brackets -`[D]' - Return the location specifier such as `[htb]'. When nothing is - entered, omit [] itself. If the possible characters are "htbp", call - this function as `(YaTeX:read-position "htbp")' - -`[F]' - YaTeX:read-coordinates -`[A]' - Base prompt, X-axis prompt, Y-axis prompt (each optional) -`[D]' - Read the coordinates with the prompt "BasePrompt X-axisPrompt:" for - X-axis, "BasePrompt Y-axisPrompt:" for Y-axis, and return it in the - form of "(X,Y)". The default prompts are `Dimension', `X', `Y' - respectively. - -`[F]' - YaTeX:check-completion-type -`[A]' - One of the symbols: 'begin, 'section, or 'maketitle -`[D]' - Check the current completion type is specified one and cause error - if not. The variable `YaTeX-current-completion-type' holds the symbol - according to the current completion type. - - - -File: yatexe, Node: Contribution, Prev: Useful functions for creating add-in, Up: Add-in functions - -Contribution ------------- - - If you make your own pretty function and you let it be in public, please -send me the function. I'm going to include it in the next release. - - - -File: yatexe, Node: Add-in generator, Prev: Add-in functions, Up: Customizations - -Add-in generator -================ - - First, don't forget to read the section of add-in functions *Note Add-in -functions::. If you easily understand how to define them, there's no need -to read this section. But being not familiar with Emacs-Lisp, when you -don't have clear idea what to do, this section describes how to get YaTeX -make add-in function. - - There are two methods of generation. One is for fully interactive -generator for beginners and another requires little knowledge of -Emacs-Lisp. - - -Generator for beginners ------------------------ - The former generator is called by - `M-x YaTeX-generate' - -strokes. All you have to do is follow the guidances. Defying them may -cases the disaster (I wonder what is it???). So when you make some -mistake, it is recommendable to type `C-g' and start afresh. - - -Simple generator ----------------- - - The latter generator is invoked by the next sequence. `M-x -YaTeX-generate-simple' This generator can make both "option add-in" and -"argument add-in" (*refer the section add-in functions* *Note How the -add-in function works::), whereas `YaTeX-generate' cannot make "argument -addin". - - For example, assume you have the LaTeX command as follows. - - \epsinput[t](250,50){hoge.eps}{plain}{Picture of foo} - (A) (B) (1) (2) (3) - (A)Optional parameter to specify the position - One of t(top), b(bottom), l(left), r(right) - (B)Maximum size of frame - (1)1st argument is filename of EPS file - (2)2nd argument indicates - plain do nothing - frame make frame around image - dframe make double-frame around image - for included EPS file. - (3)Caption for the picture - - Now get start with generation. Typing `M-x YaTeX-generate-simple' -brings the prompt: - (O)ption? (A)rgument? - - -Generating "option add-in" -.......................... - - Since (A), (B) above are optional argument, all we have to do to -complete them is define the option add-in for them. Let's generate the -function to complete (A). - - M-x YaTeX-generate-simple RET - epsinput RET - o - -Typing as above leads the next prompt. - - Read type(1): (S)tring (C)omplete (F)ile ([)option (P)osition co(O)rd. (q)uit - - This asks that "Which type is the completion style of 1st argument?". -Here are the possible completion style. - -`String' - read plain string -`Complete' - read with completion -`File' - read file name -`Option' - read optional string (if string omitted, omit [] too) -`Position' - read positional option (like [htbp]) -`Coord.' - read coordinates -`Quit' - quit from generating - - Since (A) is the optional argument to specify the location of included -EPS file, the completion style is `Position', and the possible characters -are t, b, l, and r. To tell these information to generator, operate as -follows. - - Read type(1).... p - Acceptable characters: tblr RET - - (B) is coordinate. So its completion style is coOrd. We want a prompt -meaning "Maximum size" when completion. - - Read type(2).... o - Prompt for coordinates: Max size RET - - That's all for optional argument. Select quit. - - Read type(3).... q - - Then the generated option add-in function for \epsinput will be shown in -the next window. - - -Generating "argument add-in" -............................ - - Next, create the argument add-in. The arguments for \epsinput are EPS -file name, framing style, and caption string in sequence. - - M-x YaTeX-generate-simple RET - epsinput RET - a - - Above key strokes bring the prompt that asks the number of argument. -Answer it with 3. - - How many arguments?: 3 RET - - Then the generator asks the completion style and prompt for completion. -Answer them. `f' for FileName and prompt string. - - Read type(1).... f - Prompt for argument#1 EPS file name RET - - The second argument is one of selected symbol. So the completion type -is `Completion'. - - Read type(2).... c - Prompt for argument#2 Include style RET - - Then all the candidates ready to be read. Type single RET after -entering all. - - Item[1](RET to exit): plain RET - Item[2](RET to exit): frame RET - Item[3](RET to exit): dframe RET - Item[4](RET to exit): RET - - The following prompt asks whether the entered string must belong to -candidates or not. In this case, since the argument must be one of -`plain', `frame', and `dframe', type `y'. - - Require match? (y or n) y - - The last argument is the caption string for which any completion is -needed. - - Read type(3).... s - Prompt for argument#3 Caption RET - default: Figure of RET - - Finally we'll get the argument add-in in the next window. - - -Contribution ------------- - - If you get your own pretty function and you let it be in public, please -steel yourself in the happy atmosphere and do not send me the function. I -do know it is not fine because it is generated by yatexgen:-p. - - - -File: yatexe, Node: Etcetera, Next: Copying, Prev: Customizations, Up: Top - -Etcetera -******** - - The standard completion tables provided in `yatex.el' contain a few -LaTeX commands I frequently use. This is to lessen the key strokes to -complete entire word, because too many candidates rarely used often cause -too many hits. Therefore always try to use completion in order to enrich -your dictionary, and you will also find `Wild Bird' growing suitable for -your LaTeX style. - - The package name `Wild Bird' is the English translation of Japanese -title `Yachou', which is a trick on words of Japanese. - - - -File: yatexe, Node: Copying, Prev: Etcetera, Up: Top - -Copying -******* - - This program is distributed as a free software. You can -use/copy/modify/redistribute this software freely but with NO warranty to -anything as a result of using this software. Adopting code from this -program is also free. But I would not do contract act. - -Any reports and suggestions are welcome as long as I feel interests in -this software. My possible e-mail address is `yuuji@yatex.org'. (as of -Jan.2004) And there is mailing list for YaTeX. Although the common -language is Japanese, questions in English will be welcome. To join the -ML, send the mail whose subject is `append' to the address -`yatex@yatex.org. If you have some question, please ask to -`yatex-admin@yatex.org'. - - The specification of this software will be surely modified (depending on -my feelings) without notice :-p. - - - HIROSE Yuuji - - -Tag table: -Node: Top146 -Node: What is YaTeX?1487 -Node: Main features1860 -Node: Installation3452 -Node: Typesetting4229 -Node: Calling typesetter5298 -Node: Calling previewer7502 -Node: Printing out7863 -Node: %#notation8155 -Node: Changing typesetter8531 -Node: Splitting input files8895 -Node: Static region for typesetting10319 -Node: Lpr format11448 -Node: Editing %# notation12505 -Node: Completion13024 -Node: Begin-type completion13584 -Node: Section-type completion16627 -Node: view-sectioning19062 -Node: Large-type completion20642 -Node: Maketitle-type completion21373 -Node: Arbitrary completion21925 -Node: End completion22315 -Node: Accent completion22785 -Node: Image completion23402 -Node: Greek letters completion25659 -Node: Local dictionaries26386 -Node: Commenting out27323 -Node: Cursor jump28782 -Node: Jump to corresponding object29094 -Node: Invoking image processor30495 -Node: Jump to main file31838 -Node: Jumping around the environment32203 -Node: Jumping to last completion position32621 -Node: Changing and Deleting33130 -Node: Changing LaTeX commands33522 -Node: Killing LaTeX commands34699 -Node: Filling35884 -Node: Updation of includeonly37735 -Node: What column38532 -Node: Intelligent newline39617 -Node: Usepackage checker41271 -Node: Online help41862 -Node: Browsing file hierarchy43537 -Node: Cooperation with other packages45274 -Node: Customizations45979 -Node: Lisp variables46313 -Node: All customizable variables47317 -Node: Sample definitions57116 -Node: Hook variables57629 -Node: Hook file58333 -Node: Add-in functions58672 -Node: How the add-in function works59532 -Node: Defining option-add-in61731 -Node: Defining argument-add-in62453 -Node: Defining enclosing-add-in63335 -Node: How the function is called64189 -Node: Useful functions for creating add-in64865 -Node: Contribution66270 -Node: Add-in generator66544 -Node: Etcetera71916 -Node: Copying72521 - -End tag table +Info file: yatexe, -*-Text-*- +produced by `texinfo-format-buffer' +from file `yatexe.tex' +using `texinfmt.el' version 2.38 of 3 July 1998. + + + + + + +File: yatexe, Node: Top, Next: What is YaTeX?, Prev: (dir), Up: (dir) + +* Menu: + +* What is YaTeX?:: +* Main features:: What YaTeX can do +* Installation:: Guide to install +* Typesetting:: Call typesetting processes +* %#notation:: Meta-keyword `%#' +* Completion:: Input LaTeX commands with completion +* Local dictionaries:: Directory dependent completion +* Commenting out:: Commenting/uncommenting text +* Cursor jump:: Jumping to related position +* Changing and Deleting:: Changing/deleting certain unit of text +* Filling:: Filling an item or paragraph +* Updation of includeonly:: Free from maintaining includeonly +* What column:: Check what table-column the cursor belong +* Intelligent newline:: Guess requisites of new line +* Usepackage checker:: Selecting correct \usepackage is YaTeX's job +* Online help:: On-line documentation of LaTeX +* Browsing file hierarchy:: Walking through file hierarchy +* Cooperation with other packages:: Work well with gmhist, min-out +* Customizations:: How to breed `Wild Bird' +* Etcetera:: YaTeX is acquisitive. +* Copying:: Redistribution + + + + +File: yatexe, Node: What is YaTeX?, Next: Main features, Prev: Top, Up: Top + +What is YaTeX? +************** + + YaTeX automates typesetting and previewing of LaTeX and enables +completing input of LaTeX mark-up command such as `\begin{}'..`\end{}'. + + YaTeX also supports Demacs which runs on MS-DOS(386), Mule (Multi +Language Enhancement to GNU Emacs), and latex on DOS. + + + +File: yatexe, Node: Main features, Next: Installation, Prev: What is YaTeX?, Up: Top + +Main features +************* + + * Invocation of typesetter, previewer and related programs(`C-c t') + * Typesetting on static region which is independent from point + * Semiautomatic replacing of `\includeonly' + * Jumping to error line(`C-c '') + * Completing-read of LaTeX commands such as `\begin{}', `\section' etc. + (`C-c b', `C-c s', `C-c l', `C-c m') + * Enclosing text into LaTeX environments or commands (`C-u' + ABOVEKEYSTROKES) + * Displaying the structure of text at entering sectioning commands + * Lump shifting of sectioning commands (*Note view-sectioning::) + * Learning unknown/new LaTeX commands for the next completion + * Argument reading with a guide for complicated LaTeX commands + * Generating argument-readers for new/unsupported commands(`yatexgen') + * Quick changing or deleting of LaTeX commands(`C-c c', `C-c k') + * Jumping from and to inter-file, begin<->end, ref<->label(`C-c g') + * Blanket commenting out or uncommenting (`C-c >', `C-c <', `C-c ,', + `C-c .') + * Easy input of accent mark, math-mode's commands and Greek letters + (`C-c a', `;', `:') + * Online help for the popular LaTeX commands (`C-c ?', `C-c /') + * Document files hierarchy browser (`C-c d') + * Adding automatically \usepackage corresponding to inputting LaTeX + macro with completion + * Allow you to forget creating \label{}s, \ref{} or \cite{} completion + automatically generate labels. + + + +File: yatexe, Node: Installation, Next: Typesetting, Prev: Main features, Up: Top + +Installation +************ + + Put next two expressions into your `~/.emacs'. + + (setq auto-mode-alist + (cons (cons "\\.tex$" 'yatex-mode) auto-mode-alist)) + (autoload 'yatex-mode "yatex" "Yet Another LaTeX mode" t) + +Next, add certain path name where you put files of YaTeX to your +load-path. If you want to put them in `~/src/emacs', write + + (setq load-path + (cons (expand-file-name "~/src/emacs") load-path)) + +in your `~/.emacs' + + Then, yatex-mode will be automatically loaded when you visit a file +which has extension `.tex'. If yatex-mode is successfully loaded, mode +string on mode line will be turned to "YaTeX". + + + + +File: yatexe, Node: Typesetting, Next: %#notation, Prev: Installation, Up: Top + +Typesetting +*********** + + The prefix key stroke of yatex-mode is `C-c' (Press 'C' with Control +key) by default. If you don't intend to change the prefix key stroke, +assume all `[prefix]' as `C-c' in this document. These key strokes +execute typeset or preview command. + +`[prefix] t j' + ... invoke latex +`[prefix] t r' + ... invoke latex on region +`[prefix] t e' + ... invoke latex on current environment or whole portion of + current formulas in math-mode. +`[prefix] t d' + ... invoke dvipdfmx after successful typesetting +`[prefix] t k' + ... kill current typesetting process +`[prefix] t b' + ... invoke bibtex +`[prefix] t i' + ... invoke makeindex +`[prefix] t d' + ... invoke latex && dvipdfmx +`[prefix] t p' + ... preview +`[prefix] t l' + ... lpr dvi-file +`[prefix] t s' + ... search current string on xdvi-remote + +* Menu: + +* Calling typesetter:: +* Calling previewer:: +* Printing out:: + + + +File: yatexe, Node: Calling typesetter, Next: Calling previewer, Prev: Typesetting, Up: Typesetting + +Calling typesetter +================== + + Typing `[prefix] t j', the current editing window will be divided +horizontally when you invoke latex command, and log message of LaTeX +typesetting will be displayed in the other window; called typesetting +buffer. The typesetting buffer automatically scrolls up and traces LaTeX +warnings and error messages. If you see latex stopping by an error, you +can send string to latex in the typesetting buffer. + + If an error stops the LaTeX typesetting, this key stroke will move the +cursor to the line where LaTeX error is detected. + +`[prefix] '' +`([prefix]+single quotation)' + + ... jump to the previous error or warning + + If you find a noticeable error, move to the typesetting buffer and move +the cursor on the line of error message and type `SPACE' key. This makes +the cursor move to corresponding source line. + + YaTeX-typeset-region invoked by `[prefix] tr' call typesetter for +region. The region is specified by standard point and mark, or by +`%#BEGIN' and `%#END' marks. Selected region will be copied to the +temporary file `texput.tex' with the same preamble as the main file of +current editing sources. Be sure to put all local macro settings in +preamble, not after `\begin{document}'. The method of specification of +the region is shown in the section *Note %#notation::. + + The documentclass for typeset-region is the same as that of editing file +if you edit one file, and is the same as main file's if you edit splitting +files. + + The `[prefix] te' key automatically marks current inner environment or +inner math mode and then call typeset-region with marked region. This is +convenient to quick view of current tabular environment or current editing +formulas. Keeping previewer window for `texput.dvi' is handy for +debugging. Since `[prefix] te' selects the inner-most environment as +region, it is not suitable for partial typesetting of doubly or more +composed environment. If you want to do partial typesetting for a nested +environment, use `[prefix] tr' for static-region, which is described in +the section *Note %#notation::. + + + +File: yatexe, Node: Calling previewer, Next: Printing out, Prev: Calling typesetter, Up: Typesetting + +Calling previewer +================= + + `[prefix] t p' invokes the TeX previewer. And if you are using +xdvi-remote, which can be controled from other terminals, `[prefix] t s' +enables you to search current string at the cursor on the running xdvi +window. + + + +File: yatexe, Node: Printing out, Prev: Calling previewer, Up: Typesetting + +Printing out +============ + + When you type `[preifx] t l', YaTeX asks you the range of dvi-printing +by default. You can skip this by invoking it with universal-argument as +follows: + + C-u [prefix] tl + + + +File: yatexe, Node: %#notation, Next: Completion, Prev: Typesetting, Up: Top + +%# notation +*********** + + You can control the typesetting process by describing `%#' notations in +the source text. + +* Menu: + +* Changing typesetter:: +* Splitting input files:: +* Static region for typesetting:: +* Lpr format:: +* Controlling which command to invoke:: +* Editing %# notation:: + + + +File: yatexe, Node: Changing typesetter, Next: Splitting input files, Prev: %#notation, Up: %#notation + +To change the `latex' command or to split a source text. +======================================================== + + To change the typesetting command, write + + %#!latex-big + +anywhere in the source text. This is useful for changing typesetter. + + + +File: yatexe, Node: Splitting input files, Next: Static region for typesetting, Prev: Changing typesetter, Up: %#notation + +Splitting input files +===================== + + And if you split the source text and edit subfile that should be +included from main text. + + %#!latex main.tex + +will be helpful to execute latex on main file from sub text buffer. Since +this command line after `%#!' will be sent to shell literally, next +description makes it convenient to use ghostview as dvi-previewer. + + %#!latex main && dvi2ps main.dvi > main + +Note that YaTeX assumes the component before the last period of the last +word in this line as base name of the main LaTeX source. The `%f' +notation in this line is replaced by main file name, and `%r' replaced by +root name of main file name. If you specify `%f' or `%r', YaTeX always +ask you the name of main file at the first typesetting. + + To make best use of the feature of inter-file jumping by `[prefix] g' +(see *Note Cursor jump::), take described below into consideration. + + * You can put split texts in sub directory, but not in sub directory of + sub directory. + * In the main text, specify the child file name with relative path name + such as \include{chap1/sub}, when you include the file in a + sub-directory. + * In a sub-text, write `%#!latex main.tex' even if `main.tex' is in the + parent directory(not %#!latex ../main.tex). + + + +File: yatexe, Node: Static region for typesetting, Next: Lpr format, Prev: Splitting input files, Up: %#notation + +Static region +============= + + Typeset-region by `[prefix] tr' passes the region between point and mark +to typesetting command by default. But when you want to typeset static +region, enclose the region by `%#BEGIN' and `%#END' as follows. + + %#BEGIN + TheRegionYouWantToTypesetManyTimes + %#END + +This is the rule of deciding the region. + + 1. If there exists %#BEGIN before point, + + 1. If there exists %#END after %#BEGIN, + * From %#BEGIN to %#END. + + 2. If %#END does not exist after %#BEGIN, + * From %#BEGIN to the end of buffer. + + 2. If there does not exist %#BEGIN before point, + * Between point and mark(standard method of Emacs). + + It is useful to write `%#BEGIN' in the previous line of \begin and +`%#END' in the next line of \`end' when you try complex environment such +as `tabular' many times. It is also useful to put only `%#BEGIN' alone at +the middle of very long text. Do not forget to erase `%#BEGIN' `%#END' +pair. + + + +File: yatexe, Node: Lpr format, Next: Controlling which command to invoke, Prev: Static region for typesetting, Up: %#notation + +Lpr format +========== + + Lpr format is specified by three Lisp variables. Here are the default +values of them. + +`(1)dviprint-command-format' + `"dvi2ps %f %t %s | lpr"' +`(2)dviprint-from-format' + `"-f %b"' +`(3)dviprint-to-format' + `"-t %e"' + + On YaTeX-lpr, `%s' in (1) is replaced by the file name of main text, +`%f' by contents of (2), %t by contents of (3). At these replacements, +`%b' in (2) is also replaced by the number of beginning page, `%e' in (3) +is replaced by the number of ending page. But `%f' and `%t' are ignored +when you omit the range of print-out by `C-u [prefix] tl'. + + If you want to change this lpr format temporarily, put a command such as +follows somewhere in the text: + + %#LPR dvi2ps %f %t %s | 4up -page 4 | texfix | lpr -Plp2 + + And if you want YaTeX not to ask you the range of printing out, the next +example may be helpful. + + %#LPR dvi2ps %s | lpr + + + +File: yatexe, Node: Controlling which command to invoke, Next: Editing %# notation, Prev: Lpr format, Up: %#notation + +Controlling which command to invoke +=================================== + +These %# notation below can control which command to invoke for LaTeX +related process. + + `%#BIBTEX' + + ... Command line for makeindex ([prefix] t i) + `%#MAKEINDEX' + + ... Command line for bibtex ([prefix] t b) + +If you want to invoke "makeidx hogehoge" to update index, put the next +line some upper place in the source, for example. + + %#MAKEINDEX makeidx hogehoge + + + + +File: yatexe, Node: Editing %# notation, Prev: Controlling which command to invoke, Up: %#notation + +Editing %# notation +=================== + + To edit `%#' notation described above, type + +`[prefix] %' + ... editing %# notation menu + +and select one of the entry of the menu as follows. + + !)Edit-%#! B)EGIN-END-region L)Edit-%#LPR + +Type `!' to edit `%#!' entry, `b' to enclose the region with `%#BEGIN' and +`%#END', and `l' to edit `%#LPR' entry. When you type `b', all `%#BEGIN' +and `%#END' are automatically erased. + + + +File: yatexe, Node: Completion, Next: Local dictionaries, Prev: %#notation, Up: Top + +Completion +********** + + YaTeX makes it easy to input the LaTeX commands. There are several +kinds of completion type, begin-type, section-type, large-type, etc... + +* Menu: + +* Begin-type completion:: +* Section-type completion:: +* Large-type completion:: +* Maketitle-type completion:: +* Arbitrary completion:: +* End completion:: +* Accent completion:: +* Image completion:: +* Greek letters completion:: + + + +File: yatexe, Node: Begin-type completion, Next: Section-type completion, Prev: Completion, Up: Completion + +Begin-type completion +===================== + + "Begin-type completion" completes commands of `\begin{env}' ... +`\end{env}'. All of the begin-type completions begin with this key +sequence. + +`[prefix] b' + ... start begin-type completion + +An additional key stroke immediately completes a frequently used LaTeX +`\begin{}'...`\`end'{}' environment. + +`[prefix] b c' + ... `\begin{center}...\end{center}' +`[prefix] b d' + ... `\begin{document}...\end{document}' +`[prefix] b D' + ... `\begin{description}...\end{description}' +`[prefix] b e' + ... `\begin{enumerate}...\end{enumerate}' +`[prefix] b E' + ... `\begin{equation}...\end{equation}' +`[prefix] b i' + ... `\begin{itemize}...\end{itemize}' +`[prefix] b l' + ... `\begin{flushleft}...\end{flushleft}' +`[prefix] b m' + ... `\begin{minipage}...\end{minipage}' +`[prefix] b t' + ... `\begin{tabbing}...\end{tabbing}' +`[prefix] b T' + ... `\begin{tabular}...\end{tabular}' +`[prefix] b^T' + ... `\begin{table}...\end{table}' +`[prefix] b p' + ... `\begin{picture}...\end{picture}' +`[prefix] b q' + ... `\begin{quote}...\end{quote}' +`[prefix] b Q' + ... `\begin{quotation}...\end{quotation}' +`[prefix] b r' + ... `\begin{flushright}...\end{flushright}' +`[prefix] b v' + ... `\begin{verbatim}...\end{verbatim}' +`[prefix] b V' + ... `\begin{verse}...\end{verse}' + + Any other LaTeX environments are made by completing-read of the Emacs +function. + +`[prefix] b SPACE' + ... begin-type completion + +The next message will show up in the minibuffer + + Begin environment(default document): + +by typing `[prefix] b'. Put the wishing environment with completion in +the minibuffer, and `\begin{env}'...\`\end{env}' will be inserted in the +LaTeX source text. If the environment you want to put does not exist in +the YaTeX completion table, it will be registered in the user completion +table. YaTeX automatically saves the user completion table in the user +dictionary file at exiting of emacs. + +At the completion of certain environments, the expected initial entry will +automatically inserted such as `\item' for `itemize' environment. If you +don't want the entry, it can be removed by undoing. + + If you want to enclose some paragraphs which have already been written, +invoke the begin-type completion with changing the case of `b' of key +sequence upper(or invoke it with universal argument by `C-u' prefix). + + The following example encloses a region with `description' environment. + +`[prefix] B D' +`(or ESC 1 [prefix] b D)' +`(or C-u [prefix] b D)' + + ... begin-type completion for region + + This enclosing holds good for the completing input by `[prefix] b SPC'. +`[prefix] B SPC' enclose a region with the environment selected by +completing-read. + + + +File: yatexe, Node: Section-type completion, Next: Large-type completion, Prev: Begin-type completion, Up: Completion + +Section-type completion +======================= + + "Section-type completion" completes section-type commands which take an +argument or more such as `\section{foo}'. To invoke section-type +completion, type + +`[prefix] s' + ... section-type completion + +then the prompt + + (C-v for view) \???{} (default documentclass): + +will show up in the minibuffer. Section-type LaTeX commands are completed +by space key, and the default value is selected when you type nothing in +the minibuffer. + + Next, + + \section{???}: + +prompts you the argument of section-type LaTeX command. For example, the +following inputs + + \???{} (default documentclass): section + \section{???}: Hello world. + +will insert the string + + \section{Hello world.} + +in your LaTeX source. When you neglect argument such as + + (C-v for view) \???{} (default section): vspace* + \vspace*{???}: + +YaTeX puts + + \vspace*{} + +and move the cursor in the braces. + + In LaTeX command, there are commands which take more than one arguments +such as `\addtolength{\topmargin}{8mm}'. To complete these commands, +invoke section-type completion with universal argument as, + + C-u 2 [prefix] s (or ESC 2 [prefix] s) + +and make answers in minibuffer like this. + + (C-v for view) \???{} (default vspace*): addtolength + \addtolength{???}: \topmargin + Argument 2: 8mm + +`\addtolength' and the first argument `\topmargin' can be typed easily by +completing read. Since YaTeX also learns the number of arguments of +section-type command and will ask that many arguments in future +completion, you had better tell the number of arguments to YaTeX at the +first completion of the new word. But you can change the number of +arguments by calling the completion with different universal argument +again. + + + Invoking section-type completion with `[Prefix] S' (Capital `S') +includes the region as the first argument of section-type command. + + The section/large/maketitle type completion can work at the prompt for +the argument of other section-type completion. Nested LaTeX commands are +efficiently read with the recursive completion by typing YaTeX's +completion key sequence in the minibuffer. + +* Menu: + +* view-sectioning:: + + + +File: yatexe, Node: view-sectioning, Prev: Section-type completion, Up: Section-type completion + +view-sectioning +--------------- + + In the minibuffer at the prompt of section-type command completion, +typing `C-v' shows a list of sectioning commands in source text(The line +with `<<--' mark is the nearest sectioning command). Then, default +sectioning command appears in the minibuffer. You can go up/down +sectioning command by typing `C-p'/`C-n', can scrolls up/down the listing +buffer by `C-v'/`M-v', and can hide sectioning commands under certain +level by 0 through 6. Type `?' in the minibuffer of sectioning prompt +for more information. + + You can generate this listing buffer (`*Sectioning Lines*' buffer) by +typing +`M-x YaTeX-section-overview' + ... Generate *Sectioning Lines* buffer + +from the LaTeX source buffer. In this listing buffer, typing `u' on the +sectioning command shifts up the corresponding sectioning command in +source text and `d' shifts down. After marking lines in the listing +buffer, typing `U' shifts up all sectioning commands in the region, and +`U' shifts down. Here are all the key bindings of `*Sectioning Lines*' +buffer. + +`SPC' + ... Jump to corresponding source line +`.' + ... Display corresponding source line +`u' + ... Shift up a sectioning line +`d' + ... Shift down a sectioning line +`U' + ... Shift up sectioning lines in region +`D' + ... Shift down sectioning lines in region +`0...6' + ... Hide sectioning commands whose level is lower than n + + + + +File: yatexe, Node: Large-type completion, Next: Maketitle-type completion, Prev: Section-type completion, Up: Completion + +Large-type completion +===================== + + "Large-type completion" inputs the font or size changing descriptions +such as `{\large }'. When you type + +`[prefix] l' + ... large-type completion + +the message in the minibuffer + + {\??? } (default large): + +prompts prompts you large-type command with completing-read. There are +TeX commands to change fonts or sizes, `it', `huge' and so on, in the +completion table. + + Region-based completion is also invoked by changing the letter after +prefix key stroke as `[prefix] L'. It encloses the region by braces with +large-type command. + + + +File: yatexe, Node: Maketitle-type completion, Next: Arbitrary completion, Prev: Large-type completion, Up: Completion + +Maketitle-type completion +========================= + + We call it "maketitle-type completion" which completes commands such as +`\maketitle'. Take notice that maketitle-type commands take no arguments. +Then, typing + +`[prefix] m' + ... maketitle-type completion + +begins maketitle-completion. Above mentioned method is true for +maketitle-completion, and there are LaTeX commands with no arguments in +completion table. + + + +File: yatexe, Node: Arbitrary completion, Next: End completion, Prev: Maketitle-type completion, Up: Completion + +Arbitrary completion +==================== + + You can complete certain LaTeX command anywhere without typical +completing method as described, by typing + +`[prefix] SPC' + ... arbitrary completion + +after the initial string of LaTeX command that is preceded by `\'. + + + +File: yatexe, Node: End completion, Next: Accent completion, Prev: Arbitrary completion, Up: Completion + +End completion +============== + + YaTeX automatically detects the opened environment and close it with +\`\end{environment}'. Though proficient YaTeX users never fail to make +environment with begin-type completion, some may begin an environment +manually. In that case, type + +`[prefix] e' + ... `end' completion + +at the end of the opened environment. + + + +File: yatexe, Node: Accent completion, Next: Image completion, Prev: End completion, Up: Completion + +Accent completion +================= + + When you want to write the European accent marks(like `\`{o}'), + +`[prefix] a' + ... accent completion + +shows the menu + + 1:` 2:' 3:^ 4:" 5:~ 6:= 7:. u v H t c d b + +in the minibuffer. Chose one character or corresponding numeric, and you +will see + + \`{} + +in the editing buffer with the cursor positioned in braces. Type one more +character `o' for example, then + + \`{o} + +will be completed, and the cursor gets out from braces. + + + +File: yatexe, Node: Image completion, Next: Greek letters completion, Prev: Accent completion, Up: Completion + +Image completion of mathematical sign +===================================== + + Arrow marks, sigma mark and those signs mainly used in the TeX's math +environment are completed by key sequences which imitate the corresponding +symbols graphically. This completion only works in the math environment. +YaTeX automatically detects whether the cursor located in math environment +or not, and change the behavior of key strokes `;' and `:'. + + By the way, we often express the leftarrow mark by `<-' for example. +Considering such image, you can write `\leftarrow' by typing `<-' after +`;' (semicolon) as a prefix. In the same way, `\longleftarrow' (`<--') is +completed by typing `;<--', infinity mark which is imitated by `oo' is +completed by typing `;oo'. + + Here are the sample operations in YaTeX math-mode. + + INPUT Completed LaTeX commands + ; < - `\leftarrow' + ; < - - `\longleftarrow' + ; < - - > `\longleftrightarrow' + ; o `\circ' + ; o o `\infty' + + In any case, you can quit from image completion and can move to the next +editing operation if the LaTeX command you want is shown in the buffer. + + `;' itself in math-environment is inserted by `;;'. Typing `TAB' in the +midst of image completion shows all of the LaTeX commands that start with +the same name as string you previously typed in. In this menu buffer, +press `RET' after moving the cursor (by `n', `p', `b', `f') to insert the +LaTeX command. + + To know all of the completion table, type `TAB' just after `;'. And +here is the sample menu by `TAB' after `;<'. + + KEY LaTeX sequence sign + < \leq < + ~ + << \ll << + <- \leftarrow <- + <= \Leftarrow <= + + You can define your favorite key-vs-sequence completion table in the +Emacs-Lisp variable `YaTeX-math-sign-alist-private'. See also +`yatexmth.el' for the information of the structure of this variable. + + + +File: yatexe, Node: Greek letters completion, Prev: Image completion, Up: Completion + +Greek letters completion +======================== + + Math-mode of YaTeX provides another image completion, Greek letters +completion in the same method. After prefix `:', typing `a' makes +`\alpha', `b' makes `\beta' and `g' makes `\gamma' and so on. First, type +`:TAB' to know all the correspondence of alphabets vs. Greek letters. + + If you will find `;' or `:' doesn't work in correct position of math +environment, it may be a bug of YaTeX. Please send me a bug report with +the configuration of your text, and avoid it temporarily by typing `;' or +`:' after universal-argument(`C-u') which forces `;' and `:' to work as +math-prefix. + + + +File: yatexe, Node: Local dictionaries, Next: Commenting out, Prev: Completion, Up: Top + +Local dictionaries +****************** + + Tables for completion consist of three dictionaries; `standard +dictionary' built in `yatex.el', `user dictionary' for your common private +commands, and `local dictionary' that is effective in a certain directory. + + When you input the command unknown to YaTeX at a completion in the +minibuffer, YaTeX asks you with the following prompt; + + `foo' is not in table. Register into: U)serDic L)ocalDic N)one D)iscard + +In this menu, typing `u' updates your `user dictionary', `l' updates your +local dictionary, `n' updates only on-memory dictionary which go through +only current Emacs session, and `d' updates no dictionary and throws the +new word away. + + If you find this switching feature meaningless and bothersome, put the +next expression into your `~/.emacs' + + (setq YaTeX-nervous nil) + + + +File: yatexe, Node: Commenting out, Next: Cursor jump, Prev: Local dictionaries, Up: Top + +Commenting out +************** + + You may want to comment out some region. + +`[prefix] >' + ... comment out region by % +`[prefix] <' + ... uncomment region + +cause an operation to the region between point and mark. + +`[prefix] .' + ... comment out current paragraph +`[prefix] ,' + ... uncomment current paragraph + +comments or uncomments the paragraph where the cursor belongs. This +`paragraph' means the region marked by the function mark-paragraph, bound +to `ESC h' by default. It is NOT predictable what will happen when you +continuously comment out some paragraph many times. + + You can also comment out an environment between `\begin' and `\end', or +a `\begin'-\`\end' pair themselves, by making the following key strokes on +the line where `\begin{}' or `\end{}' exists. + +`[prefix] >' + ... comment out from \begin to \`end' +`[prefix] <' + ... uncomment from \begin to \`end' + +comment whole the contents of environment. Moreover, + +`[prefix] .' + ... comment out \begin and \`end' +`[prefix] ,' + ... uncomment \begin and \`end' + +(un)comments out only environment declaration: `\begin{}' and `\end{}'. +NOTE that even if you intend to comment out some region, invoking +`[prefix] >' on the `\begin',`\end' line decides to work in `commenting +out from `\begin' to `\end'' mode. + + + + +File: yatexe, Node: Cursor jump, Next: Changing and Deleting, Prev: Commenting out, Up: Top + +Cursor jump +*********** + + +* Menu: + +* Jump to corresponding object:: +* Invoking image processor:: +* Jump to main file:: +* Jumping around the environment:: +* Jumping to last completion position:: + + + +File: yatexe, Node: Jump to corresponding object, Next: Invoking image processor, Prev: Cursor jump, Up: Cursor jump + +Jump to corresponding object +============================ + + Typing + +`[prefix] g' + ... go to corresponding object + +in a certain place move the cursor to the place corresponding to the LaTeX +command of last place. YaTeX recognize the followings as pairs that have +relation each other. + + * `\begin{}' <-> `\end{}' + * `%#BEGIN' <-> `%#END' + * On the image-including line -> corresponding viewer or drawing tool + * `\label{}' <-> `\ref{}' + * `\include(\input)' -> included file + * `\bibitem{}' <-> `\cite{}' + + On a `\begin',`\end' line, typing `[prefix] g' moves the cursor to the +corresponding `\end',`\begin' line, if its partner really exists. The +behavior on the line `%#BEGIN' and `%#END' are the same. Note that if the +correspondent of `label/ref' or `cite/bibitem' exists in another file, +that file have to be opened to make a round trip between references by +`[prefix] g'. + + If you type `[prefix] g' on the line of `\include{chap1}', typically in +the main text, YaTeX switches buffer to `chap1.tex'. + +`[prefix] 4 g' + ... go to corresponding object in other window + +do the same job as `[prefix] g' except it's done in other window. Note +that this function doesn't work on `begin/end', `%#BEGIN/%#END' pairs +because it is meaningless. + + + +File: yatexe, Node: Invoking image processor, Next: Jump to main file, Prev: Jump to corresponding object, Up: Cursor jump + +Invoking image processor +======================== + + +`image-including line' described above means such lines as +`\epsfile{file=foo.ps}'. If you type `[prefix] g' on that line, YaTeX +automatically searches source of `foo.ps' and invokes image viewer or +drawing tool correspoinding to it. For example; if you draw an image +foo.obj with Tgif and enclose its product named foo.eps by `\epsfile' +command. Typing `[prefix] g' on `\epsfile' line make YaTeX invoke `tgif +foo.obj'. How a processor is choosen is as follows. + + 1. If there is an expression matching with one of the pattern defined in + `YaTeX-processed-file-regexp-alist', extract file name from regexp + group surrounded by \\(\\). (Which group corresponds is written in + the cdr part of each list.) If no matches were found, do nothing. + 2. If there is a pattern as `%PROCESSOR' which is defined in the + variable `YaTeX-file-processor-alist', call that processor giving the + file name with corresponding extension. + 3. If not, check the existence of each file which is supplied the + extension in the cdr part of each list of + `YaTeX-file-processor-alist'. If any, call the corresponding image + viewer or drawing tool. + + + +File: yatexe, Node: Jump to main file, Next: Jumping around the environment, Prev: Invoking image processor, Up: Cursor jump + +Jump to main file +================= + + Typing + +`[prefix] ^' + ... visit main file +`[prefix] 4^' + ... visit main file in other buffer + +in a sub text switch the buffer to the main text specified by `%#!' +notation. + + + +File: yatexe, Node: Jumping around the environment, Next: Jumping to last completion position, Prev: Jump to main file, Up: Cursor jump + +Jumping around the environment +============================== + + And these are the functions which work on the current LaTeX environment: + +`M-C-a' + ... beginning of environment +`M-C-e' + ... `end' of environment +`M-C-@' + ... mark environment + + + +File: yatexe, Node: Jumping to last completion position, Prev: Jumping around the environment, Up: Cursor jump + +Jumping to last completion position +=================================== + +YaTeX always memorize the position of completion into register `3'. So +every time you make a trip to any other part of text other than you are +writing, you can return to the editing paragraph by calling +register-to-point with argument YaTeX-current-position-register, which is +achieved by typing `C-x j 3'(by default). + + + +File: yatexe, Node: Changing and Deleting, Next: Filling, Prev: Cursor jump, Up: Top + +Changing and Deleting +********************* + + These functions are for change or deletion of LaTeX commands already +entered. + +`[prefix] c' + ... change LaTeX command +`[prefix] k' + ... kill LaTeX command + +* Menu: + +* Changing LaTeX commands:: +* Killing LaTeX commands:: + + + +File: yatexe, Node: Changing LaTeX commands, Next: Killing LaTeX commands, Prev: Changing and Deleting, Up: Changing and Deleting + +Changing LaTeX commands +======================= + +`[prefix] c' can change the various (La)TeX commands. This can change the +followings. + * Environment names + * Section-type commands + * Argument of section-type commands + * Optional parameters (enclosed by []) of section-type commands + * Font/size designators + * Math-mode's maketitle-type commands that can be inputted with image + completion + + Typing `[prefix] c' on one of above objects you want to change brings a +suitable reading function sometimes with completion. Note: If you want to +change the argument of section-type command that contains other LaTeX +commands, type `[prefix] c' either of surrounding braces of the argument +in order to make YaTeX ignore the internal LaTeX sequences as an object of +changing. Anyway, it is very difficult to know which argument position +the cursor belongs because the LaTeX commands can be nested and braces can +freely emerge. So keep it mind to put the cursor on a brace when you are +thinking of changing a complicated argument. + + + +File: yatexe, Node: Killing LaTeX commands, Prev: Changing LaTeX commands, Up: Changing and Deleting + +Killing LaTeX commands +====================== + + `[prefix] k' kills the LaTeX commands sometimes with their arguments. +Following table illustrates the correspondence of the invoking position +and what is killed. + + [Invoking position] [action] + \begin, \end line kill \begin,\end pairs + %#BEGIN, %#END line kill %#BEGIN,%#END pairs + on a Section-type command kill section-type command + on a parenthesis kill parentheses + +Note that when killing `\begin, \end' or `%#BEGIN, %#END' pair, the lines +`\begin, \end' or `%#BEGIN, %#END' exist will be killed entirely. So take +care not to create any line that contains more than one `\begin' or so. + +While all operations above are to kill `containers' which surround some +text, universal argument (`C-u') for these commands kills not only +`containers' but also `contents' of them. See below as a sample. + + Original text: [prefix] k C-u [prefix] k + Main \footnote{note} here. Main note here. Main here. + ~(cursor) + + + +File: yatexe, Node: Filling, Next: Updation of includeonly, Prev: Changing and Deleting, Up: Top + +Filling +******* + + +Filling an item +=============== + + To fill a term (descriptive sentences) of `\item', type + +`M-q' + ... fill item + +on that item. + + YaTeX uses the value of the variable `YaTeX-item-regexp' as the regular +expression to search item header in itemize environment. If you make a +newcommand to itemize terms(e.g. `\underlineitem'), put + + (setq YaTeX-item-regexp + "\\(\\\\\\(sub\\)*item\\)\\|\\(\\\\underlineitem\\)") + +in your `~/.emacs'. If you are not familiar with regular expression for +Emacs-Lisp, name a newcommand for `itemize' beginning with `\item' such as +`\itembf', not `\bfitem'. + + This function reformats the `\item' into `hang-indented' style. For +example: + + itemize, enumerate environment: + > + >\item[foo] `foo' is the typical word for describing an + > arbitrarily written.... + description environment: + > \item[bar] When the word `for' is used as an arbitrarily + > word, `bar' is bound to follow it. + + Note that the indent depth of an `\item' word and its descriptive +paragraph are the same in latter case. If you want to use different +depth, invoke fill-paragraph at the beginning of non-whitespace +character(see below). + + +Filling paragraph +================= + + Fill-paragraph is little bit adapted for LaTeX sources. It retains from +filling in certain environments where formatting leads to a disaster such +as verbatim, tabular, or so. And it protects `\verb' expressions from +being folded (The variable `YaTeX-verb-regexp' controls this). Besides, +putting cursor on the first occurrence of non-whitespace character on a +line changes the fill-prefix temporarily to the depth of the line. + + + +File: yatexe, Node: Updation of includeonly, Next: What column, Prev: Filling, Up: Top + +Updation of `\includeonly' +************************** + + When you edit splitting source texts, the notation + + \includeonly{CurrentEditingFileName} + +in the main file reduces the time of typesetting. If you want to hack +other file a little however, you have to rewrite it to + + \includeonly{OtherFileNameYouWantToFix} + +in the main file. YaTeX automatically detects that the current edited +text is not in includeonly list and prompts you + + A)dd R)eplace %)comment? + +in the minibuffer. Type `a' if you want to add the current file name to +`\includeonly' list, `r' to replace \`includeonly' list with the current +file, and type `%' to comment out the `\includeonly' line. + + + +File: yatexe, Node: What column, Next: Intelligent newline, Prev: Updation of includeonly, Up: Top + +What column? +************ + + We are often get tired of finding the corresponding column in large +tabulars. For example, + + \begin{tabular}{|c|c|c|c|c|c|c|c|}\hline + Name&Position&Post No.&Addr.&Phone No.&FAX No.& + Home Addr.&Home Phone\\ \hline + Thunder Bird & 6 & 223 & LA & xxx-yyy & + zzz-www & Japan & 9876-54321 \\ + & 2 & \multicolumn{2}{c|}{Unknown} + &&&(???) + \\ \hline + \end{tabular} + +Suppose you have the cursor located at `(???)' mark, can you tell which +column it is belonging at once? Maybe no. In such case, type + +`[prefix] &' + ... What column + +in that position. YaTeX tells you the column header of the current field. +Since YaTeX assumes the first line of tabular environment as a row of +column headers, you can create a row of virtual column headers by putting +them in the first line and commenting that line with `%'. + + + +File: yatexe, Node: Intelligent newline, Next: Usepackage checker, Prev: What column, Up: Top + +Intelligent newline +******************* + + At the end of begin-type completion of tabular[*], array, itemize, +enumerate or tabbing environment, or typing + +`ESC RET' + ... Intelligent newline + +in these environments inserts the contents corresponding to the current +environment in the next line. (At the begin-type completion, this +contents can be removed by `undo'.) In `tabular' environment, for +example, `ESC RET' inserts the certain number of `&' and trailing `\\', +and `\hline' if other `\hline' is found in backward. Here are the list of +contents vs. environments. + + * `tabular', `tabular*', `array' + + Corresponding number of `&' and `\\'. And `\hline' if + needed. + + * `tabbing' + + The same number of `\>' as `\=' in the first line. + + * `itemize', `enumerate', `description', `list' + + `\item' or `item[]'. + + Note that since this function works seeing the contents of the first +line, please call this after the second line if possible. + + If you want to apply these trick to other environments, `foo' +environment for example, define the function named +`YaTeX-intelligent-newline-foo' to insert corresponding contents. That +function will be called at the beginning of the next line after the +newline is inserted to the current line. Since the function +`YaTeX-indent-line' is designed to indent the current line properly, +calling this function before your code to insert certain contents must be +useful. See the definition of the function +`YaTeX-intelligent-newline-itemize' as an example. + + + +File: yatexe, Node: Usepackage checker, Next: Online help, Prev: Intelligent newline, Up: Top + +Usepackage checker +****************** + +When you input begint-type, section-type, maketitle-type macros with +completion, and it requires some LaTeX2e package, YaTeX examines the +existence of correct `\usepackage'. If not, YaTeX inserts the +`\usepackage{}' declaration corresponding to input macro. + +To activate the package completion for your favarite package, set the +variable `YaTeX-package-alist-private' correctly. Please refere the value +of `YaTeX-package-alist-default' as an example. + + + +File: yatexe, Node: Online help, Next: Browsing file hierarchy, Prev: Usepackage checker, Up: Top + +Online help +*********** + + YaTeX provides you the online help with popular LaTeX commands. + + Here are the key strokes for the online help. + +`[prefix] ?' + ... Online help +`[prefix] /' + ... Online apropos + + +Online help +=========== + + `Online help' shows the documentation for the popular LaTeX +commands(defaults to the commands on the cursor) in the next buffer. +There are two help file, `global help' and `private help'. The former +file contains the descriptions on the standard LaTeX command and is +specified its name by variable `YaTeX-help-file'. Usually, the global +help file should be located in public space (`$EMACSEXECPATH' by default) +and should be world writable so that anyone can update it to enrich its +contents. The latter file contains descriptions on non-standard or +personal command definitions and is specified by +`YaTeX-help-file-private'. This file should be put into private +directory. + + +Online apropos +============== + + `Online apropos' is an equivalent of GNU Emacs's apropos. It shows all +the documentations that contains the keyword entered by the user. + + +When no descriptions are found... +================================= + + If there is no description on a command in help files, YaTeX requires +you to write a description on that command. If you are willing to do, +determine which help file to add and write the description on it referring +your manual of (La)TeX. Please send me your additional descriptions if +you describe the help on some standard commands. I might want to include +it in the next distribution. + + + +File: yatexe, Node: Browsing file hierarchy, Next: Cooperation with other packages, Prev: Online help, Up: Top + +Browsing file hierarchy +*********************** + + When you are editing multi-file source, typing + +`[prefix] d' + ... browse file hierarchy + +asks you the parent-most file (which may be defaulted) and displays the +documentation hierarchy in the next window. In this buffer, the following +commands are available. + +`n' + ... move to the next line and show its contents +`p' + ... move to the previous line and show its contents +`N' + ... move to the next file in the same inclusion level +`P' + ... move to the previous file in the same inclusion level +`j' + ... move to the next line +`k' + ... move to the previous line +`u' + ... move to the parent file +`.' + ... show the current files contents in the next window +`SPC' + ... scroll up the current file window +`DEL, b' + ... scroll down the current file window +`<' + ... show the beginning of the current file +`>' + ... show the end of the current file +`>' + ... return to the previous postion after `<' or `>' +`RET, g' + ... open the current file in the next window +`mouse-2' + ... same as RET(available only with window system) +`o' + ... other window +`1' + ... delete other windows +`-' + ... shrink hierarchy buffer window +`+' + ... enlarge hierarchy buffer window +`?' + ... describe mode +`q' + ... quit + + Note that operations on the file contents in the next window do not work +correctly when you close the corresponding file. + + + +File: yatexe, Node: Cooperation with other packages, Next: Customizations, Prev: Browsing file hierarchy, Up: Top + +Cooperation with other packages +******************************* + + YaTeX works better with other brilliant packages. + + +gmhist +====== + + When you are loading `gmhist.el' and `gmhist-mh.el', you can use +independent command history list at the prompt of preview command +(`[prefix] tp') and print command (`[prefix] tl'). On each prompt, you +can enter the previous command line string repeatedly by typing `M-p'. + + +min-out +======= + + `min-out', the outline minor mode, can be used in yatex-mode buffers. +If you want to use it with YaTeX, please refer the file `yatexm-o.el' as +an example. + + + +File: yatexe, Node: Customizations, Next: Etcetera, Prev: Cooperation with other packages, Up: Top + +Customizations +************** + + You can customize YaTeX by setting Emacs-Lisp variables and by making +add-in functions. + +* Menu: + +* Lisp variables:: +* Add-in functions:: +* Add-in generator:: + + + +File: yatexe, Node: Lisp variables, Next: Add-in functions, Prev: Customizations, Up: Customizations + +Lisp variables +============== + + You can change the key assignments or make completion more comfortable +by setting the values of various variables which control the movement of +yatex-mode. + + For example, if you want to change the prefix key stroke from `C-c' to +any other sequence, set YaTeX-prefix to whatever you want to use. If you +don't want to use the key sequence `C-c letter' which is assumed to be the +user reserved sequence in Emacs world, set `YaTeX-inhibit-prefix-letter' +to `t', and all of the default key bind of `C-c letter' will turn to the +corresponding `C-c C-letter' (but the region based completions that is +invoked with `C-c Capital-letter' remain valid, if you want to disable +those bindings, set that variable to 1 instead of `t'). + +* Menu: + +* All customizable variables:: +* Sample definitions:: +* Hook variables:: +* Hook file:: + + + +File: yatexe, Node: All customizable variables, Next: Sample definitions, Prev: Lisp variables, Up: Lisp variables + +All customizable variables +-------------------------- + + Here are the customizable variables of yatex-mode. Each value setq-ed +in `~/.emacs' is preferred and that of defined in `yatex.el' is neglected. +Parenthesized contents stands for the default value. When you are to +change some of these variables, see more detailed documentation of the +variable by `M-x describe-variable'. + + -- Variable: YaTeX-japan + Set this nil to produce all messages in English (`Depends on Japanese + feature of Emacs') + + -- Variable: YaTeX-kanji-code + Default buffer-file-coding-system for YaTeX modes' buffer. Set this + 0 to no language conversion. Nil to preserve original + coding-system. 1=Shift JIS, 2=JIS, 3=EUC, 4=UTF-8 (`1 or 2') + + -- Variable: YaTeX-prefix + Prefix key stroke (`C-c') + + -- Variable: YaTeX-inhibit-prefix-letter + Change key stroke from `C-c letter' to `C-c C-letter' (`nil') + + -- Variable: YaTeX-fill-prefix + Fill-prefix used in yatex-mode (`nil') + + -- Variable: YaTeX-user-completion-table + Name of user dictionary where learned completion table will be + stored. (`"~/.yatexrc"') + + -- Variable: tex-command + LaTeX typesetter command (`"latex"') + + -- Variable: dvi2-command + Preview command (`"xdvi -geo +0+0 -s 4"') + + -- Variable: dviprint-command-format + Command format to print dvi file (`"dvi2ps %f %t %s | lpr"') + + -- Variable: dviprint-from-format + Start page format of above %f. %b will turn to start page (`"-f %b"') + + -- Variable: dviprint-to-format + End page format of above %t. %e will turn to `end' page (`"-t %e"') + + -- Variable: makeindex-command + Default makeindex command (`"makeindex"' (`"makeind"' on MS-DOS)) + + -- Variable: YaTeX-dvipdf-command + Default command name to convert .dvi to PDF (`"dvipdfmx"') + + -- Variable: YaTeX-need-nonstop + Put `\nonstopmode{}' or not (`nil') + + -- Variable: latex-warning-regexp + Regular expression of warning message latex command puts out + (`"line.* [0-9]*"') + + -- Variable: latex-error-regexp + Regular expression of error message (`"l\\.[1-9][0-9]*"') + + -- Variable: latex-dos-emergency-message + Message latex command running on DOS puts at abort (`"Emergency + stop"') + + -- Variable: YaTeX-item-regexp + Regular expression of item command (`"\\\\item"') + + -- Variable: YaTeX-verb-regexp + Regexp of verb family. Omit \\\\. (`"verb\\*?\\|path"') + + -- Variable: YaTeX-nervous + T for using local dictionary (`t') + + -- Variable: YaTeX-sectioning-regexp + Regexp of LaTeX sectioning command + (`"\\(part\\|chapter\\*?\\|\\(sub\\)*\\(section\\|paragraph\\)\\*?\\)\\b"') + + -- Variable: YaTeX-fill-inhibit-environments + Inhibit fill in these environments (`'("tabular" "tabular*" "array" + "picture" "eqnarray" "eqnarray*" "equation" "math" "displaymath" + "verbatim" "verbatim*")') + + -- Variable: YaTeX-uncomment-once + T for deleting all preceding `%' (`nil') + + -- Variable: YaTeX-close-paren-always + T for always close all parenthesis automatically, `nil' for only eol + (`t') + + -- Variable: YaTeX-auto-math-mode + Switch math-mode automatically (`t') + + -- Variable: YaTeX-math-key-list-private + User defined alist, math-mode-prefix vs completion alist used in + image completion (`nil'). See `yatexmth.el' for the information + about how to define a completion alist. + + -- Variable: YaTeX-default-pop-window-height + Initial height of typesetting buffer when one-window. Number for the + lines of the buffer, numerical string for the percentage of the + screen-height. `nil' for half height (10) + + -- Variable: YaTeX-help-file + Global online help file name + (`$doc-directory/../../site-lisp/YATEXHLP.eng') + + -- Variable: YaTeX-help-file-private + Private online help file name (`"~/YATEXHLP.eng"') + + -- Variable: YaTeX-no-begend-shortcut + Disable [prefix] b ?? shortcut (`nil)' + + -- Variable: YaTeX-hilit-pattern-adjustment-private + List of the list that contain the regular expression and the symbol + of logical meaning of the string that matches the pattern. See also + the value from `(assq 'yatex-mode hilit-patterns-alist)' and the + value of `YaTeX-hilit-pattern-adjustment-default' (and even the + document of hilit19.el). + + -- Variable: YaTeX-sectioning-level + Alist of LaTeX's sectioning command vs its height. + + -- Variable: YaTeX-hierarchy-ignore-heading-regexp + `YaTeX-display-hierarchy' searches for sectioning command first, and + comment line secondary as a file headings. In latter case, ignore lines + that match with regular expression of this variable. Default value of + this variable is RCS header expressions and mode specifying line `-*- xxxx + -*'. + + -- Variable: YaTeX-skip-default-reader + Non-nil for this variable skips the default argument reader of + section-type command when add-in function for it is not defined + (`nil') + + -- Variable: YaTeX-create-file-prefix-g + When typing `prefix g' on the `\include' line, open the target file + even if the file doesn't exist (`nil') + + -- Variable: YaTeX-simple-messages + Simplyfy messages of various completions (`nil') + + -- Variable: YaTeX-hilit-sectioning-face + When hilit19 and yatex19 is active, YaTeX colors the sectioning + commands. This variable specifies the foreground and background + color of `\part' macro. The default value is `'(yellow/dodgerblue + yellow/slateblue)'. The first element of this list is for the screen + when `hilit-background-mode' is `'light', and the second element is + for `'dark'. You should specify both color as `forecolor/backcolor'. + + -- Variable: YaTeX-hilit-sectioning-attenuation-rate + When color mode, this variable specifies how much attenuate the color + density of `\subparagraph' compared with that of `\chapter' (`'(15 + 40)') See also `YaTeX-hilit-sectioning-face'. + + -- Variable: YaTeX-use-AMS-LaTeX + If you use AMS-LaTeX, set to `t' (`nil') + + -- Variable: YaTeX-use-LaTeX2e + If you use LaTeX2e, set to `t' (`t') + + -- Variable: YaTeX-template-file + File name which is automatically inserted at creation + (`~/work/template.tex') + + -- Variable: YaTeX-search-file-from-top-directory + Non-nil means to search input-files from the directory where main + file exists (`t') + + -- Variable: YaTeX-use-font-lock + Use font-lock to fontify buffer or not (`(featurep 'font-lock)' + + -- Variable: YaTeX-use-hilit19 + Use hilit19 to highlight buffer or not (`(featurep 'hilit19)' + + -- Variable: YaTeX-use-italic-bold + YaTeX tries to search italic, bold fontsets or not (`t' if Emacs-20 + or later). This variable is effective only when font-lock is used. + (`(featurep 'hilit19)' + + -- Variable: YaTeX-singlecmd-suffix + Suffix which is always inserted after maketitle-type macros. `"{}"' + is recommended. + + -- Variable: YaTeX-package-alist-private + Alist of LaTeX2e-package name vs. lists of macros in it. Set this + alist properly and YaTeX automatically check the declaratiion of + `usepackage' for corresponding macro, when you input that macro with + completion. If required `usepackage' is not found, YaTeX also + automatically inserts `\usepackage'. Alist is as follows; + '((PackageName1 (completionType ListOfMacro) (completionType + ListOfMacro)) (PackageName2 (completionType ListOfMacro) + (completionType ListOfMacro...))....) completionType is one of `env, + section, maketitle'. Consult the value of + `YaTeX-package-alist-default' as an example. + + -- Variable: YaTeX-tabular-indentation + At indentation by `C-i' in tabular or array environment, YaTeX put + the additional spaces to the normail indentation depth. The number + of additional spaces is the product of YaTeX-tabular-indentation and + the number of column position in tabular. + + -- Variable: YaTeX-noindent-env-regexp + Regexp of environment names that should begin with no indentation. + All verbatime-like environment name should match with. + + -- Variable: YaTeX-ref-default-label-string + Default \\ref time string format. This format is like strftime(3) + but allowed conversion char are as follows; %y -> Last 2 digit of + year, %b -> Month name, %m -> Monthe number(1-12), %d -> Day, %H -> + Hour, %M -> Minute, %S -> Second, %qx -> alphabetical-decimal + conversion of yymmdd. %qX -> alphabetical-decimal conversion of + HHMMSS. Beware defualt label-string should be always unique. So + this format string should have both time part (%H+%M+%S or %qX) and + date part (%y+(%b|%m)+%d or %qx). + + -- Variable: YaTeX-ref-generate-label-function + Function to generate default label string for unnamed \\label{}s. + The function pointed to this value should take two arguments. First + argument is LaTeX macro's name, second is macro's argument. Here is + an example for using this value. + (setq YaTeX-ref-generate-label-function 'my-yatex-generate-label) + (defun my-yatex-generate-label (command value) + (and (string= command "caption") + (re-search-backward "\\\\begin{\\(figure\\|table\\)}" nil t) + (setq command (match-string 1))) + (let ((alist '(("chapter" . "chap") + ("section" . "sec") + ("subsection" . "subsec") + ("figure" . "fig") + ("table" . "tbl")))) + (if (setq command (cdr (assoc command alist))) + (concat command ":" value) + (YaTeX::ref-generate-label nil nil)))) + + + + +File: yatexe, Node: Sample definitions, Next: Hook variables, Prev: All customizable variables, Up: Lisp variables + +Sample definitions +------------------ + + For instance, to change the prefix key stroke to `ESC', and name of the +user dictionary `~/src/emacs/yatexrc', and set `fill-prefix' to single TAB +character, add the following `setq' to `~/.emacs'. + + (setq YaTeX-prefix "\e" + YaTeX-user-completion-table "~/src/emacs/yatexrc" + YaTeX-fill-prefix " ") + + + +File: yatexe, Node: Hook variables, Next: Hook file, Prev: Sample definitions, Up: Lisp variables + +Hook variables +-------------- + + More customizations will be done by the hook-function defined in +hook-variable `yatex-mode-hook'. This is useful to define a shortcut key +sequence to enter some environments other than `document' and `enumerate' +etc. The following statement defines `[prefix] ba' to enter +`\begin{abstract}' ... `=end{abstract}' immediately. + + (setq yatex-mode-hook + '(lambda() (YaTeX-define-begend-key "ba" "abstract"))) + + You should use functions `YaTeX-define-key', or +`YaTeX-define-begend-key' to define all the key sequences of yatex-mode. + + + +File: yatexe, Node: Hook file, Prev: Hook variables, Up: Lisp variables + +Hook file +--------- + + You can stuff all of YaTeX related expressions into a file named +`yatexhks.el' if you have a lot of codes. YaTeX automatically load this +file at the initialization of itself. Using `yatexhks.el' makes +`yatex-mode-load-hook' unnecessary. + + + +File: yatexe, Node: Add-in functions, Next: Add-in generator, Prev: Lisp variables, Up: Customizations + +Add-in functions +================ + + You can easily define a function to input detailed arguments with +completion according to LaTeX environments or commands. + + +What is add-in functions? +------------------------- + + When you input `tabular' environment, don't you think "I want YaTeX to +complete its argument toward my favorite one such as `{|c|c|c|}'..."? +Yes, you can define the function to complete arguments for any environment +and any LaTeX commands. + + +Procedure +--------- + + Here is the procedure to define add-in functions. + 1. Define the function + 2. Put the function into `yatexhks.el' + +* Menu: + +* How the add-in function works:: +* How the function is called:: +* Useful functions for creating add-in:: +* Contribution:: + + + +File: yatexe, Node: How the add-in function works, Next: How the function is called, Prev: Add-in functions, Up: Add-in functions + +How the add-in function works +----------------------------- + +There are three types of add-in. + + 1. Option add-in + 2. argument add-in + 3. enclosing add-in + +"Option add-in" returns the LaTeX's optional parameters such as optional +strings after `\begin{ENV}', optional strings between a section-type +command and its first argument, and optional strings just after type +maketitle-type command. The following illustrates the name of add-in +functions, where underlined strings are generated by add-in functions. + + \begin{table}[ht] (Function name: YaTeX:table) + ~~~~ + \put(100,200){} (Function name: YaTeX:put) + ~~~~~~~~~ + \sum_{i=0}^{n} (Function name: YaTeX:sum) + ~~~~~~~~~~ + + Obviously, the function name is decided by concatenating the prefix +`YaTeX:' and LaTeX command's name. + + Another add-in type is "argument add-in", which completes arguments for +section-type commands. + + \newcommand{\foo}{bar} (Function name: YaTeX::newcommand) + ~~~~ ~~~ + + When the section-type command is inputted, the function named by +concatenating `YaTeX::' and section-type command, is called automatically +with an integer argument which indicates which argument of section-type +command is being read. Thus the add-in should determine the job referring +the value of its argument. + + "enclosing add-in" is for modifying and/or checking the region that will +be enclosed by section-type commands via `[prefix] S'. An enclosing +add-in function will be called with two arguments, beginning of the +enclosed region and end of the region. Suppose you want to enclose the +existing text `(a+b)/c' by `\frac{}'. + + a/c + | | + A B + +You do set-mark-command at point A and then move to point B. Typing +`[prefix] S' and input `frac' enclose the region like this; + + \frac{a/c} + +Normally, the expression `a/c' is translated to `\frac{a}{c}'. An +enclosing add-in is useful for modifying `/' to `}{'. + +* Menu: + +* Defining option-add-in:: +* Defining argument-add-in:: +* Defining enclosing-add-in:: + + + +File: yatexe, Node: Defining option-add-in, Next: Defining argument-add-in, Prev: How the add-in function works, Up: How the add-in function works + +Defining `option add-in' +........................ + + If you want `{|c|c|c|}' for all `tabular' environment, + + (defun YaTeX:tabular () + "{|c|c|c|}") + +is enough. If you want more complicated format, define as below. + + (defun YaTeX:tabular () + "{@{\\vrule width 1pt\\ }|||@{\\ \\vrule width 1pt}}") + +Note that the character `\' must be described as `\\' in Emacs-Lisp. The +next example reads the tabular format from keyboard. + (defun YaTeX:tabular () + (concat "{" (read-string "Rule: ") "}")) + + + +File: yatexe, Node: Defining argument-add-in, Next: Defining enclosing-add-in, Prev: Defining option-add-in, Up: How the add-in function works + +Defining `argument add-in' +.......................... + + This section describes how to define the add-in function for +`\newcommand'. + + The first argument of `\newcommand' begins always with `\'. The second +argument is usually so complex that we can not edit them in the +minibuffer. Here is the created function considering this. + + (defun YaTeX::newcommand (n) ;n is argument position + (cond + ((= n 1) ;1st argument is macro name + (read-string "Command: " "\\")) ;initial input `\' + ((= n 2) "") ;do nothing when reading arg#2 + (t nil))) + + Note that when the `argument add-in' function return `nil', normal +argument reader will be called. + + + +File: yatexe, Node: Defining enclosing-add-in, Prev: Defining argument-add-in, Up: How the add-in function works + +Defining `enclosing add-in' +........................... + + This section describes how to define the add-in function for text +enclosed by `\frac{}'. + + When enclosing the text `5/3' by `\frac{}', you might want to replace +`/' with `}{'. Enclosing function `YaTeX::frac-region' is called with two +arguments, beginning of enclosed text and end of enclosed text. The +function is expected to replace `/' with `}{'. Here is an example +expression. + + (defun YaTeX::frac-region (beg end) + (catch 'done + (while (search-forward "/" end t) + (goto-char (match-beginning 0)) + (if (y-or-n-p "Replace this slash(/) with `}{'") + (throw 'done (replace-match "}{"))) + (goto-char (match-end 0))))) + + + +File: yatexe, Node: How the function is called, Next: Useful functions for creating add-in, Prev: How the add-in function works, Up: Add-in functions + +How the function is called +-------------------------- + + YaTeX calls the add-in functions for specified begin-type, section-type, +and maketitle-type command, if any. `Option add-in' functions for +begin-type are called when `\begin{ENV}' has been inserted, functions for +section-type are called just before input of the first argument, and +functions for maketitle-type is called after maketitle-type command has +been inserted. `Argument add-in' functions are called at each entry of +arguments for section-type commands. + + + +File: yatexe, Node: Useful functions for creating add-in, Next: Contribution, Prev: How the function is called, Up: Add-in functions + +Useful functions for creating add-in +------------------------------------ + + Many add-in functions for typical LaTeX commands are defined in +`yatexadd.el'. Those are also useful as references. Here are the short +descriptions on useful functions, where [F] means function, [A] means +arguments, [D] means description. + +`[F]' + YaTeX:read-position +`[A]' + Character list which can show up in the brackets +`[D]' + Return the location specifier such as `[htb]'. When nothing is + entered, omit [] itself. If the possible characters are "htbp", call + this function as `(YaTeX:read-position "htbp")' + +`[F]' + YaTeX:read-coordinates +`[A]' + Base prompt, X-axis prompt, Y-axis prompt (each optional) +`[D]' + Read the coordinates with the prompt "BasePrompt X-axisPrompt:" for + X-axis, "BasePrompt Y-axisPrompt:" for Y-axis, and return it in the + form of "(X,Y)". The default prompts are `Dimension', `X', `Y' + respectively. + +`[F]' + YaTeX:check-completion-type +`[A]' + One of the symbols: 'begin, 'section, or 'maketitle +`[D]' + Check the current completion type is specified one and cause error + if not. The variable `YaTeX-current-completion-type' holds the symbol + according to the current completion type. + + + +File: yatexe, Node: Contribution, Prev: Useful functions for creating add-in, Up: Add-in functions + +Contribution +------------ + + If you make your own pretty function and you let it be in public, please +send me the function. I'm going to include it in the next release. + + + +File: yatexe, Node: Add-in generator, Prev: Add-in functions, Up: Customizations + +Add-in generator +================ + + First, don't forget to read the section of add-in functions *Note Add-in +functions::. If you easily understand how to define them, there's no need +to read this section. But being not familiar with Emacs-Lisp, when you +don't have clear idea what to do, this section describes how to get YaTeX +make add-in function. + + There are two methods of generation. One is for fully interactive +generator for beginners and another requires little knowledge of +Emacs-Lisp. + + +Generator for beginners +----------------------- + The former generator is called by + `M-x YaTeX-generate' + +strokes. All you have to do is follow the guidances. Defying them may +cases the disaster (I wonder what is it???). So when you make some +mistake, it is recommendable to type `C-g' and start afresh. + + +Simple generator +---------------- + + The latter generator is invoked by the next sequence. `M-x +YaTeX-generate-simple' This generator can make both "option add-in" and +"argument add-in" (*refer the section add-in functions* *Note How the +add-in function works::), whereas `YaTeX-generate' cannot make "argument +addin". + + For example, assume you have the LaTeX command as follows. + + \epsinput[t](250,50){hoge.eps}{plain}{Picture of foo} + (A) (B) (1) (2) (3) + (A)Optional parameter to specify the position + One of t(top), b(bottom), l(left), r(right) + (B)Maximum size of frame + (1)1st argument is filename of EPS file + (2)2nd argument indicates + plain do nothing + frame make frame around image + dframe make double-frame around image + for included EPS file. + (3)Caption for the picture + + Now get start with generation. Typing `M-x YaTeX-generate-simple' +brings the prompt: + (O)ption? (A)rgument? + + +Generating "option add-in" +.......................... + + Since (A), (B) above are optional argument, all we have to do to +complete them is define the option add-in for them. Let's generate the +function to complete (A). + + M-x YaTeX-generate-simple RET + epsinput RET + o + +Typing as above leads the next prompt. + + Read type(1): (S)tring (C)omplete (F)ile ([)option (P)osition co(O)rd. (q)uit + + This asks that "Which type is the completion style of 1st argument?". +Here are the possible completion style. + +`String' + read plain string +`Complete' + read with completion +`File' + read file name +`Option' + read optional string (if string omitted, omit [] too) +`Position' + read positional option (like [htbp]) +`Coord.' + read coordinates +`Quit' + quit from generating + + Since (A) is the optional argument to specify the location of included +EPS file, the completion style is `Position', and the possible characters +are t, b, l, and r. To tell these information to generator, operate as +follows. + + Read type(1).... p + Acceptable characters: tblr RET + + (B) is coordinate. So its completion style is coOrd. We want a prompt +meaning "Maximum size" when completion. + + Read type(2).... o + Prompt for coordinates: Max size RET + + That's all for optional argument. Select quit. + + Read type(3).... q + + Then the generated option add-in function for \epsinput will be shown in +the next window. + + +Generating "argument add-in" +............................ + + Next, create the argument add-in. The arguments for \epsinput are EPS +file name, framing style, and caption string in sequence. + + M-x YaTeX-generate-simple RET + epsinput RET + a + + Above key strokes bring the prompt that asks the number of argument. +Answer it with 3. + + How many arguments?: 3 RET + + Then the generator asks the completion style and prompt for completion. +Answer them. `f' for FileName and prompt string. + + Read type(1).... f + Prompt for argument#1 EPS file name RET + + The second argument is one of selected symbol. So the completion type +is `Completion'. + + Read type(2).... c + Prompt for argument#2 Include style RET + + Then all the candidates ready to be read. Type single RET after +entering all. + + Item[1](RET to exit): plain RET + Item[2](RET to exit): frame RET + Item[3](RET to exit): dframe RET + Item[4](RET to exit): RET + + The following prompt asks whether the entered string must belong to +candidates or not. In this case, since the argument must be one of +`plain', `frame', and `dframe', type `y'. + + Require match? (y or n) y + + The last argument is the caption string for which any completion is +needed. + + Read type(3).... s + Prompt for argument#3 Caption RET + default: Figure of RET + + Finally we'll get the argument add-in in the next window. + + +Contribution +------------ + + If you get your own pretty function and you let it be in public, please +steel yourself in the happy atmosphere and do not send me the function. I +do know it is not fine because it is generated by yatexgen:-p. + + + +File: yatexe, Node: Etcetera, Next: Copying, Prev: Customizations, Up: Top + +Etcetera +******** + + The standard completion tables provided in `yatex.el' contain a few +LaTeX commands I frequently use. This is to lessen the key strokes to +complete entire word, because too many candidates rarely used often cause +too many hits. Therefore always try to use completion in order to enrich +your dictionary, and you will also find `Wild Bird' growing suitable for +your LaTeX style. + + The package name `Wild Bird' is the English translation of Japanese +title `Yachou', which is a trick on words of Japanese. + + + +File: yatexe, Node: Copying, Prev: Etcetera, Up: Top + +Copying +******* + + This program is distributed as a free software. You can +use/copy/modify/redistribute this software freely but with NO warranty to +anything as a result of using this software. Adopting code from this +program is also free. But I would not do contract act. + +Any reports and suggestions are welcome as long as I feel interests in +this software. My possible e-mail address is `yuuji@yatex.org'. (as of +Jan.2004) And there is mailing list for YaTeX. Although the common +language is Japanese, questions in English will be welcome. To join the +ML, send the mail whose subject is `append' to the address +`yatex@yatex.org. If you have some question, please ask to +`yatex-admin@yatex.org'. + + The specification of this software will be surely modified (depending on +my feelings) without notice :-p. + + + HIROSE Yuuji + +Tag table: +Node: Top149 +Node: What is YaTeX?1490 +Node: Main features1863 +Node: Installation3392 +Node: Typesetting4169 +Node: Calling typesetter5299 +Node: Calling previewer7503 +Node: Printing out7864 +Node: %#notation8156 +Node: Changing typesetter8574 +Node: Splitting input files8938 +Node: Static region for typesetting10363 +Node: Lpr format11492 +Node: Controlling which command to invoke12565 +Node: Editing %# notation13158 +Node: Completion13702 +Node: Begin-type completion14262 +Node: Section-type completion17305 +Node: view-sectioning19740 +Node: Large-type completion21320 +Node: Maketitle-type completion22051 +Node: Arbitrary completion22603 +Node: End completion22993 +Node: Accent completion23463 +Node: Image completion24080 +Node: Greek letters completion26337 +Node: Local dictionaries27064 +Node: Commenting out28001 +Node: Cursor jump29460 +Node: Jump to corresponding object29772 +Node: Invoking image processor31173 +Node: Jump to main file32516 +Node: Jumping around the environment32881 +Node: Jumping to last completion position33299 +Node: Changing and Deleting33808 +Node: Changing LaTeX commands34200 +Node: Killing LaTeX commands35377 +Node: Filling36562 +Node: Updation of includeonly38413 +Node: What column39210 +Node: Intelligent newline40295 +Node: Usepackage checker41949 +Node: Online help42540 +Node: Browsing file hierarchy44215 +Node: Cooperation with other packages45952 +Node: Customizations46657 +Node: Lisp variables46991 +Node: All customizable variables47995 +Node: Sample definitions57794 +Node: Hook variables58307 +Node: Hook file59011 +Node: Add-in functions59350 +Node: How the add-in function works60210 +Node: Defining option-add-in62409 +Node: Defining argument-add-in63131 +Node: Defining enclosing-add-in64013 +Node: How the function is called64867 +Node: Useful functions for creating add-in65543 +Node: Contribution66948 +Node: Add-in generator67222 +Node: Etcetera72594 +Node: Copying73199 + +End tag table diff --git a/docs/yatexe.tex b/docs/yatexe.tex index 371a2f7..ac9d9e5 100644 --- a/docs/yatexe.tex +++ b/docs/yatexe.tex @@ -5,7 +5,7 @@ @iftex @c @syncodeindex fn cp -@c Last modified Sun Apr 15 22:51:34 2012 on firestorm +@c Last modified Thu May 10 11:12:44 2012 on firestorm @syncodeindex vr cp @end iftex @@ -15,7 +15,7 @@ @subtitle Yet Another tex-mode for emacs @title Wild Bird @subtitle // YaTeX // -@author @copyright{} 1991-2003 by HIROSE, Yuuji [yuuji@@yatex.org] +@author @copyright{} 1991-2012 by HIROSE, Yuuji [yuuji@@yatex.org] @end titlepage @node Top, What is YaTeX?, (dir), (dir) diff --git a/docs/yatexj b/docs/yatexj index f275797..1507207 100644 --- a/docs/yatexj +++ b/docs/yatexj Binary files differ diff --git a/docs/yatexj.tex b/docs/yatexj.tex index 64b8067..03d7bfc 100644 --- a/docs/yatexj.tex +++ b/docs/yatexj.tex Binary files differ diff --git a/makefile b/makefile index 05e8962..8d04cae 100644 --- a/makefile +++ b/makefile @@ -49,7 +49,7 @@ # make clean to delete all producted files # make ci to check in all # make co to check out all -MVER = 1.75 +MVER = 1.76 LISP = ${LISP18} ${LISP19} YAHTML = yahtml.el COMMON = yatexlib.el yatexprc.el diff --git a/yahtml.el b/yahtml.el index 53ab59f..151ba30 100644 --- a/yahtml.el +++ b/yahtml.el @@ -1,9 +1,9 @@ ;;; -*- Emacs-Lisp -*- ;;; (c) 1994-2012 by HIROSE Yuuji [yuuji(@)yatex.org] -;;; Last modified Thu Feb 9 08:36:16 2012 on firestorm +;;; Last modified Thu May 10 11:06:39 2012 on firestorm ;;; $Id$ -(defconst yahtml-revision-number "1.75" +(defconst yahtml-revision-number "1.76" "Revision number of running yahtml.el") ;;;[Installation] diff --git a/yatex.el b/yatex.el index 20d216d..71179b1 100644 --- a/yatex.el +++ b/yatex.el @@ -1,15 +1,15 @@ ;;; -*- Emacs-Lisp -*- ;;; Yet Another tex-mode for emacs - //�쒹// -;;; yatex.el rev. 1.75.3 +;;; yatex.el rev. 1.76 ;;; (c)1991-2012 by HIROSE Yuuji.[yuuji@yatex.org] -;;; Last modified Thu Feb 9 09:52:41 2012 on firestorm +;;; Last modified Thu May 10 11:06:33 2012 on firestorm ;;; $Id$ ;;; The latest version of this software is always available at; ;;; http://www.yatex.org/ (require 'comment) (require 'yatexlib) -(defconst YaTeX-revision-number "1.75.3" +(defconst YaTeX-revision-number "1.76" "Revision number of running yatex.el") ;---------- Local variables ----------
' $(B$r$$$l$?$iI,$: (B`
' $(B$rF~$l$FM_$7$$4D6-!# - (B(`"^\\(body\\|dl\\|blockquote\\)"') - - -- Variable: yahtml-template-file - $(B?75,(BHTML$(B%U%!%$%k:n@.;~$K<+F0E*$KA^F~$7$FM_$7$$%U%!%$%kL>!# - (B`"~/http/template.html"' - - -- Variable: yahtml-prefer-upcases - $(B%?%0$KBgJ8;z$r;H$$$?$$!#(B`nil' - - -- Variable: yahtml-prefer-upcase-attributes - $(BB0@-;XDj;R$KBgJ8;z$r;H$$$?$$!#(B`nil' - - -- Variable: yahtml-server-type - Apache$(B7O$N%5!<%P$rMxMQ$7$F$$$k>l9g$O (B'apache $(B$r%;%C%H$9$k!# - (B./.htaccess $(B$r;2>H$9$k$+$I$&$+$r7hDj$9$k!#(B`'apache' - - -- Variable: yahtml-apache-access-file - `yahtml-server-type' $(B$, (B`'apache' $(B$N$H$-$K%"%/%;%9@)8B%U%!%$%kL>$r;X - Dj!#(B`".htaccess"' - - -- Variable: yahtml-shell-command-option - $(B%7%'%k$GJL%3%^%s%I$r5/F0$9$k$H$-$N%*%W%7%g%s!# - - (B-- Variable: yahtml-translate-hyphens-when-comment-region - $(BNN0h%3%a%s%H%"%&%H$r$9$k$H$-$K4{$KB8:_$9$k%O%$%U%s$r (B`-' $(B$KJQ99$9 - $k$+$I$&$+!#(B(`t') - - -- Variable: yahtml-entity-reference-chars-alist - $(B%(%s%F%#%F%#;2>H(B(Entity Reference)$(B$G5-=R$9$Y$-J8;z72$r(B`'(?$(BJ8;z (B. "$(B%( - %s%F%#%F%#I=5-(B")' $(B$H$$$&7A<0$rNs5s$7$?(Balist$(B$GJB$Y$k!#%G%U%)%k%H$G - (B`<', `>', `&', `'', `"' $(B$KBP$9$k(Balist$(B$,@_Dj$5$l$F$$$k$N$G!"DI2C$7$?$$ - J,$@$1$r5-=R$9$l$PNI$$!#(Bcdr$(BIt (B`"$(B%(%s%F%#%F%#I=5-(B"' $(B$O!"@hF,$N (B`&' $(B$H - KvHx$N(B`;' $(B$O4^$a$:$K=q$/!# - - (B-- Variable: yahtml-faithful-to-htmllint - $(B9=J8%A%'%C%+$H$7$F (Bhtmllint $(B$rMxMQ$9$k>l9g$A$g$C$H$7$?M>7W$J6uGr$J$I - $KBP$7$F$b7Y9p$r<($9$N$G!"$3$l$r2sHr$9$k$H$-$K$O$3$NJQ?t$r(B`t'$(B$K$9$k!# - - (B-- Variable: yahtml-use-css - CSS$(B$NJd405!G=$r;H$&$+$I$&$+ (B(`t') - - -- Variable: yahtml-image-inspection-bytes - $(B2hA|%U%!%$%k$N%5%$%:$rD4$Y$k$H$-$KFI$_9~$`%P%$%H?t (B(`10000') - - -- Variable: yahtml:img-default-alt-format - $(B$N(BALT$(BB0@-$N%G%U%)%k%HJ8;zNs$N=q<0!#(B%x$(B$O2hA|$NI}!"(B%y$(B$O2hA| - $N9b$5!"(B%s$(B$O%U%!%$%k%5%$%:$KCV49$5$l$k (B(`"%xx%y(%sbytes)"') - - -- Variable: yahtml-escape-chars - href$(BJd40$J$I$N$H$-$KM=LsJ8;z$r(BURL$(B%(%s%3!<%I$9$k$+(B; 'ask$(B$N$H$-$O3NG'$7 - $F$+$iCV49$9$k (B(`'ask') - - -- Variable: yahtml-use-font-lock - $(B%=!<%9$N?'$E$1%Q%C%1!<%8$H$7$F (Bfont-lock $(B$rMxMQ$9$k$+(B(`(featurep - 'font-lock)') - - -- Variable: yahtml-use-hilit19 - $(B%=!<%9$N?'$E$1%Q%C%1!<%8$H$7$F (Bhilit19 $(B$rMxMQ$9$k$+(B(`(featurep - 'hilit19)') - - -- Variable: yahtml-indentation-boundary - $(B%$%s%G%s%H7W;;$rBG$A@Z$C$F$h$$6-3&$H$J$k@55,I=8=(B(`"^\\s *"') - - - -File: yahtmlj, Node: Hook variables, Prev: All customizable variables, Up: Customizations - -hook$(BJQ?t -(B======== - - - - -File: yahtmlj, Node: Copying, Next: Concept Index, Prev: Customizations, Up: Top - -$(B:\Ey$K4X$7$F$O@)8B$$$? -$7$^$;$s!#>o<1E*$K07$C$F$/$@$5$$!#$^$?!";HMQ$7$F$$$k;]$r%a%$%k$G$*CN$i$;$$ -$?$@$/$H!":np!"4uK>!"%P%0Js9p!"46A[Ey$O4?7^$$$?$7$^$9!#O"Mm$O (Byuuji@yatex.org $(B$^ -$G(B(2000$(BG/(B12$(B7n8=:_(B)$(B!#7QB3E*$K;HMQ$7$F$/$@$5$kJ}$O%a%$%j%s%0%j%9%H!V(Bfj$(BLnD;$N -2q!W$K@'Hs2CF~$7$F$/$@$5$$!#2CF~J}K!$K$D$$$F$OK\%Q%C%1!<%8$N (B`docs/htmlqa' -$(B%U%!%$%k$N!V$=$NB>!W$N>O$r8fMw$/$@$5$$!# - -;EMM$O!"M=9p$J$/3NH$X$NJQ99(B5300 -Node: $(B%j%8%g%sFbJ8;z$N(BURLencode5658 -Node: td$(B3g$j(B/tr$(B3g$j(B5890 -Node: CSS Support6519 -Node: CSS-class completion6738 -Node: Reread CSS file7734 -Node: Customizations7956 -Node: All customizable variables8180 -Node: Hook variables11178 -Node: Copying11290 -Node: Concept Index11793 - -End tag table +Info file: yahtmlj, -*-Text-*- +produced by `texinfo-format-buffer' +from file `yahtmlj.tex' +using `texinfmt.el' version 2.38 of 3 July 1998. + + + + + + +File: yahtmlj, Node: Top, Next: Intro, Prev: (dir), Up: (dir) + +* Menu: + +* Intro:: �͂��߂� +* Installation:: �C���X�g�[�� +* Command Invocation:: �O���R�}���h�N�� +* Completion:: �⊮���� +* Jump:: �J�[�\���W�����v +* Changing and Deleting:: �ύX�ƍ폜 +* CSS Support:: �X�^�C���V�[�g�⊮ +* Customizations:: �J�X�^�}�C�Y�ϐ��ꗗ +* Copying:: �Ƃ肠���� +* Concept Index:: ���� + + + + +File: yahtmlj, Node: Intro, Next: Installation, Prev: Top, Up: Top + +�͂��߂� +******** + +yahtml�� GNU Emacs ��� HTML�������쐬���鎞�ɁA�ɎG��HTML�^�O�̓��͂�⊮ +�@�\�ɂ���ăX���[�Y�ɍs����悤�ɂ��邾���łȂ��Aweblint�Ȃǂ̍\���`�F�b +�N�v���O�����A�J�[�\���ʒu��URL��t�@�C�����Ɉˑ������u���E�U/�C���[�W�����[ +�A�̋N���Ȃǂ� Emacs �ҏW��ʒ�����s����悤�ɂ���p�b�P�[�W�ł��B + +(����Info�͖������ł�(__)�c) + + + +File: yahtmlj, Node: Installation, Next: Command Invocation, Prev: Intro, Up: Top + +�C���X�g�[�� +************ +* Menu: + +* yahtml�N���̂��߂̐ݒ�:: +* lint�v���O����/�u���E�U/�C���[�W�����[�A�����̐ݒ�:: +* WWW�y�[�W���p�ϐ��̐ݒ�:: + + + +File: yahtmlj, Node: yahtml�N���̂��߂̐ݒ�, Next: lint�v���O����/�u���E�U/�C���[�W�����[�A�����̐ݒ�, Prev: Installation, Up: Installation + +yahtml�N���̂��߂̐ݒ� +====================== + + +`~/.emacs'�ɉ���2���ڂ������܂��B + + (setq auto-mode-alist + (cons (cons "\\.html$" 'yahtml-mode) auto-mode-alist)) + (autoload 'yahtml-mode "yahtml" "Yet Another HTML mode" t) + +����yahtml�ɕK�v�ȃt�@�C��(`yahtml.el', `yatexlib.el', `yatexprc.el') ��u +���f�B���N�g���� load-path �ɉ����܂��B���Ƃ��A `~/src/emacs/yahtml'�ɒu +���̂ł���A + + (setq load-path (cons (expand-file-name "~/src/emacs/yahtml") load-path)) + +�ȂǂƂ��܂��B + + �ȏ�̐ݒ�ɂ��A�g���q�� .html �ł���t�@�C����ҏW����Ǝ����I�� +yahtml �����[�h����܂��Byahtml������ɋN���ł����Ƃ��̓��[�h���C���̕\�� +���uyahtml�v�ɕς��܂��B + + + +File: yahtmlj, Node: lint�v���O����/�u���E�U/�C���[�W�����[�A�����̐ݒ�, Next: WWW�y�[�W���p�ϐ��̐ݒ�, Prev: yahtml�N���̂��߂̐ݒ�, Up: Installation + +lint�v���O����/�u���E�U/�C���[�W�����[�A�����̐ݒ� +==================================================== + +���p����O���v���O�����ȂǂɊւ���ȉ��̕ϐ����m�F���A�K�v�Ȃ琳�����l�ɕ� +�X���܂�(���ʓ��̓f�t�H���g�l)�B +`yahtml-www-browser' + ... �N������u���E�U�̃R�}���h��(netscape) +`yahtml-image-viewer' + ... �N������摜�r���[�A�̃R�}���h��(xv) +`yahtml-lint-program' + ... �\���`�F�b�N�v���O�����̃R�}���h��(jweblint) +`yahtml-kanji-code' + ... html�t�@�C���̊����R�[�h + + + +File: yahtmlj, Node: WWW�y�[�W���p�ϐ��̐ݒ�, Prev: lint�v���O����/�u���E�U/�C���[�W�����[�A�����̐ݒ�, Up: Installation + +WWW�y�[�W���p�ϐ��̐ݒ� +========================= + +�z�[���y�[�W�ƂȂ�t�@�C�������݂���PATH���Ɋւ���ϐ���ݒ肵�܂��B +`yahtml-path-url-alist' + ... �t�@�C���V�X�e�����PATH���ƁAURL�̑Ή��\ +`yahtml-directory-index' + ... URL�w��Ńt�@�C�������ȗ������Ƃ��ɕ\�������C���f�b�N�X + �t�@�C����(NCSA�nhttpd�Ȃ� `index.html', CERN�n�Ȃ�`Welcome.html'���� + �ʓI) + +�ϐ� `yahtml-path-url-alist' �̐ݒ��������܂��B�Ⴆ�A����ł́A +`/home/yuuji/http/' �� `http://localhost/~yuuji' �ŎQ�Ƃł��A�E��ł� +`/usr/home/yuuji/www/' ��`http://www.keio.ac.jp/~yuuji/' �ŎQ�Ƃł���悤 +�ɂȂ��Ă���ꍇ�͈ȉ��̂悤�ɐݒ肵�܂��B + + (setq yahtml-path-url-alist + '(("/home/yuuj/http" . "http://localhost/~yuuji") + ("/usr/home/yuuj/www" . "http://www.keio.ac.jp/~yuuji"))) + +���̑Ή��g�͂�����ł��ݒ肷�邱�Ƃ��ł��܂��B + + + +File: yahtmlj, Node: Command Invocation, Next: Completion, Prev: Installation, Up: Top + +�O���R�}���h�N�� +**************** + +HTML�t�@�C���ҏW�ɂ�����邢�����̃R�}���h���ɌĂԂ��Ƃ��ł��܂��B +`[prefix] t j' + ... HTML�\���`�F�b�J(jweblint)�N�� +`[prefix] t p' + ... ���݂̃y�[�W��ΏۂƂ����u���E�U�N�� +`[prefix] t r' + ... ���݂̃y�[�W���u���E�U�ɕ\������Ă���Ƃ���reload�w�� + + + +File: yahtmlj, Node: Completion, Next: Jump, Prev: Command Invocation, Up: Top + +�⊮���� +******** + +�u�쒹�v�ŗ��p�ł���A�ubegin�^�⊮�v�A�usection�^�⊮�v�A�ularge�^�⊮�v�A +�umaketitle�^�⊮�v�A�u�A�N�Z���g�⊮�v�ƑS�������L�[����őΉ�����HTML�^ +�O�̕⊮���͂��ł��܂��B���ꂼ��̌^�̕⊮�͏��ɁA�u�����s�ɓn��^�O���́v�A +�u��v�f�^�O(img�Ȃ�)�̕⊮�v�A�u��s���ł̊J�n/�I���^�O�̓��́v�A�u��v�f +���^�O�̓��́v�A�u�����Q�Ɠ��́v�ɑΉ����Ă��܂��B��̓I�ɂ� + +`[prefix] b (�쒹��begin�⊮�ɑΉ�)' + ... + + + + �̂悤�ɊJ�n�^�O�ƏI���^�O���s�ɓn���ď��������ꍇ�̕⊮���w���܂��B + �����Ƀu���b�N�^�^�O���⊮���Ɋ܂܂�܂��B + +`[prefix] s (�쒹��section�^�⊮�ɑΉ�)' + ... + + + �̂悤�ɏI���^�O���������A�������l�݂̂ŋ@�\���w�肷��^�O��⊮�� + �܂��B�⊮���Ƃ��ẮAimg, input �����݂��܂��B + +`[prefix] l (�쒹��large�^�⊮�ɑΉ�)' + ... begin�^�⊮�Ƃقړ����ł����A + + �` + + �̂悤�Ɉ�s���ɊJ�n/�I���^�O����ꂽ���Ƃ��ɗ��p���܂��B + +`[prefix] m (�쒹��maketitle�^�⊮�ɑΉ�)' + ... �v�f�������l�������Ȃ��^�O��⊮���͂��܂��B + �Ȃǂ��⊮���ɑ������܂��B + +`[prefix] a (�쒹�̃A�N�Z���g�⊮�ɑΉ�)' + ... �G���e�B�e�B�Q�Ƃɂ�镶���\�L����͂���Ƃ��ɗp���܂��B + �f�t�H���g�ł� < (<), > (>), & (&), " ("), ' ('), + �u�����N ( ) �̕⊮���͂��s���܂��B + + + +File: yahtmlj, Node: Jump, Next: Changing and Deleting, Prev: Completion, Up: Top + +�J�[�\���W�����v +**************** +�������̂��낢��ȏꏊ�� + +`[prefix] g' + ... �Ή�����I�u�W�F�N�g�ɃW�����v + +���������Ƃɂ��A�J�[�\���ʒu��HTML�\���ɑΉ�����ꏊ�ɃW�����v���܂��B�� +���W�����݂���Ɖ��߂����R�}���h�ɂ͈ȉ��̂��̂�����܂��B + + * `' ���� `' + * `' �� �Ή�����viewer�N�� + * `' �� �����N��ւ̃|�C���g�ړ� + * `' �� Java�\�[�X�v���O�����ւ̈ړ� + + + +File: yahtmlj, Node: Changing and Deleting, Next: CSS Support, Prev: Jump, Up: Top + +�ύX/�폜 +********* + +* Menu: + +* �^�O�̕ύX:: +* �����Q�Ƃւ̕ύX:: +* ���W������������URLencode:: +* td����/tr����:: + + + +File: yahtmlj, Node: �^�O�̕ύX, Next: �����Q�Ƃւ̕ύX, Prev: Changing and Deleting, Up: Changing and Deleting + +�^�O�̕ύX +============ +�������̂��낢��ȏꏊ�� + +`[prefix] c' + ... �Ή�����^�O����ύX + +���������Ƃɂ��A�J�[�\���ʒu��HTML�\���ɉ������L�q���e�̕ύX���s���܂��B +�J�[�\���ʒu�ƕύX������e�̑Ή��͈ȉ��̒ʂ�ł��B + + * `'�``' + ... `TAG' �̕ύX + * `' �Ȃǂ̑����l + ... �����l�̕ύX + + + +File: yahtmlj, Node: �����Q�Ƃւ̕ύX, Next: ���W������������URLencode, Prev: �^�O�̕ύX, Up: Changing and Deleting + +�����Q�Ƃւ̕ύX +================ +�����Ƃ��Ă� < �� > ��\������Ƃ��́A�����Q�Ƃ�p����< �� > �ƕ\�L +����K�v������܂����AHTML�ȊO�̃t�@�C�����炱���̕������܂ރe�L�X�g�� +�荞�ꍇ�ȂǂɁA�����̕������ꊇ���ĕ����Q�ƌ`���ɕϊ��ł��܂��B + +`[prefix] ;' + ... �w�肵���̈�̕����Q�Ƃɒu��������ׂ������̒u�� +`[prefix] :' + ... �w�肵���̈�̕����Q�Ƃ��Q�ƕ������̂��̂ɒu��([prefix] ; + �̋t�ϊ�) + + + + +File: yahtmlj, Node: ���W������������URLencode, Next: td����/tr����, Prev: �����Q�Ƃւ̕ύX, Up: Changing and Deleting + +���W������������URLencode +========================= + `[prefix] #' + + ... �w�肵���̈���� URLencode ���ׂ�����������������G�� + �R�[�h�\�L�ɒu���B + + + +File: yahtmlj, Node: td����/tr����, Prev: ���W������������URLencode, Up: Changing and Deleting + +td����/tr���� +============= +���ŏ������\�`���̍s���R�[�h�� ����̕��сC���邢�͂������� +��� �Ŋ������s���тɕϊ��ł��܂��B + `[prefix] }' + + ... ���݂̃��W�����ɂ���f�[�^����育�Ƃ� + ... �Ŋ��� + `[prefix] ]' + + ... ���݂̃��W�����ɂ���s����Ltd������قǂ����Ă��炳��ɍs���� +�� ... �Ŋ���f�t�H���g�ł͋��ł����C�����ς���Ƃ��� +Delimiter: �̖₢���킹�ɋ�蕶�����w�肵�܂��B���Ƃ��J���}(,) ���w�� +�����CSV����\����邱�Ƃ��ł��܂��B + +td�ȊO�̗v�f�C��̓I�ɂ� th �Ŋ��肽���ꍇ�� universal-argument (`C-u') �� +���ď�L2�̃R�}���h���Ăт܂��B�ǂ̗v�f�Ŋ��邩�̎��₪������̂ł��� +�� th �Ɠ����C�e�t�B�[���h�� ... �Ŋ���܂��B�����C��1�t�B�[ +���h�̂� th �ŁC�c���S�� td ����ɂ������Ƃ��� thd �Ɠ��͂��ĉ������B + + + +File: yahtmlj, Node: CSS Support, Next: Customizations, Prev: Changing and Deleting, Up: Top + +CSS(�X�^�C���V�[�g)�T�|�[�g +*************************** + +* Menu: + +* CSS-class completion:: +* Reread CSS file:: + + + +File: yahtmlj, Node: CSS-class completion, Next: Reread CSS file, Prev: CSS Support, Up: CSS Support + +CSS�N���X���⊮ +=============== +HTML����CSS(Cascading Style Sheets)�̃N���X����⊮���͂��邱�Ƃ��ł��܂��B +�X�^�C����`�Ƃ��� + + h1.foo, h2.foo { background-color: 0xffffff; } + h1.bar, h2.bar { font-size: 120%; } + +�̂悤�Ȃ��̂��������ꍇ�ɁAh1�܂���h2�^�O�� [prefix] b �� [prefix] l �ŕ� +�����͂����ꍇ�ɁA�����ɗL���� class ���ł��� foo, bar �����Ƃ��ĕ⊮ +���͂��邱�Ƃ��\�ł��B�܂� + + .caution { font-size: 120%; background-color: 0xc00000;} + +�̂悤�ȑS�ẴG�������g�ɓ���class����`����Ă����ꍇ�́A�S�Ẵ^�O�̕� +�����͎���class�Q�Ɠ��͂����߂��܂��B���ꂪ�ς킵���ꍇ�̓G�������g���� +�͊m��̂Ƃ��Ƀ��^�[���L�[(�܂���C-m)�ł͂Ȃ��AC-j��������class�⊮���͂� +�L�����Z���ł��܂��B���Ƃ��� + + [prefix] l �s���^�O�⊮���N�� + (�܂���[prefix] l SPC) + tt �����ꂽ���̂�tt�Ɠ��� + C-m + +�Ƃ����ꍇ�͑����� class= �ƕ⊮�v�����v�g���o�܂����A + + [prefix] l �s���^�O�⊮���N�� + (�܂���[prefix] l SPC) + tt �����ꂽ���̂�tt�Ɠ��� + C-j + +�ƍŌ�� `C-j' �œ��͂����ꍇ�� class �⊮�v�����v�g�͏o�܂���B + + + +File: yahtmlj, Node: Reread CSS file, Prev: CSS-class completion, Up: CSS Support + +CSS��`�t�@�C���̓ǂݒ��� +========================= +html�t�@�C����ҏW����CSS��`�t�@�C�����C�����A�lj�����class��⊮���Ƃ� +�Ē����ɓǂݍ��܂������ꍇ�́A`M-x yahtml-mode' �Ƃ��čċN�����s���Ă����� +���B + + + +File: yahtmlj, Node: Customizations, Next: Copying, Prev: CSS Support, Up: Top + +�J�X�^�}�C�Y +************ + +yahtml�̓���𐧌䂷��ϐ��ɂ��Đ������܂��B + +* Menu: + +* All customizable variables:: �J�X�^�}�C�Y�ϐ��ꗗ +* Hook variables:: hook�ϐ� + + + +File: yahtmlj, Node: All customizable variables, Next: Hook variables, Prev: Customizations, Up: Customizations + +�J�X�^�}�C�Y�ϐ��ꗗ +==================== + + -- Variable: yahtml-prefix + yahtml-mode ���̃v���t�B�N�X�L�[ (`\C-c') + + -- Variable: yahtml-image-viewer + img�ŎQ�Ƃ��Ă���摜�t�@�C����\������Ƃ��ɋN������R�}���h (xv) + + -- Variable: yahtml-www-browser + `[prefix]g' �ŊO���y�[�W��\������Ƃ��ɋN������u���E�U (netscape) + + -- Variable: yahtml-kanji-code + �f�t�H���g�̊����R�[�h�B1=sjis, 2=jis, 3=euc, 4=utf-8 (2) + .htaccess �t�@�C���� + AddType "text/html; charset=xxx" .html �̋L�q���������ꍇ�͂��� + �ɏ]�� + + -- Variable: yahtml-fill-column + auto-fill����Ƃ��̃J������ (72) + + -- Variable: yahtml-fill-prefix + yahtml-mode �ŗL��fill-prefix (`nil') + + -- Variable: yahtml-path-url-alist + OS�̃t�@�C���V�X�e����ł̃t���p�X���ƁA���̊O�����J����URL�̑Ή��\�B + + -- Variable: yahtml-directory-index + �T�[�o�A�N�Z�X���t�@�C�������ȗ������Ƃ��Ƀf�t�H���g�ŊJ�����C���f�b + �N�X�t�@�C���̖��O�B�����̏ꍇ index.html�B(`"index.html"') + + -- Variable: yahtml-lint-program + HTML�\���`�F�b�N�v���O�����B(`"jweblint"') + + -- Variable: yahtml-hate-too-deep-indentation + �l�X�g�����n���ł̃C���f���g���[������Ƃ���t�ɂ���B(`nil') + + -- Variable: yahtml-always-/p + `' �����ꂽ��K�� `' �������l�����B`nil' + + -- Variable: yahtml-p-prefered-env-regexp + �����I�� `' �����ė~�������B + (`"^\\(body\\|dl\\|blockquote\\)"') + + -- Variable: yahtml-template-file + �V�KHTML�t�@�C���쐬���Ɏ����I�ɑ}�����ė~�����t�@�C�����B + `"~/http/template.html"' + + -- Variable: yahtml-prefer-upcases + �^�O�ɑ啶�����g�������B`nil' + + -- Variable: yahtml-prefer-upcase-attributes + �����w��q�ɑ啶�����g�������B`nil' + + -- Variable: yahtml-server-type + Apache�n�̃T�[�o�𗘗p���Ă���ꍇ�� 'apache ���Z�b�g����B + ./.htaccess ���Q�Ƃ��邩�ǂ��������肷��B`'apache' + + -- Variable: yahtml-apache-access-file + `yahtml-server-type' �� `'apache' �̂Ƃ��ɃA�N�Z�X�����t�@�C�������w + ��B`".htaccess"' + + -- Variable: yahtml-shell-command-option + �V�F���ŕʃR�}���h���N������Ƃ��̃I�v�V�����B + + -- Variable: yahtml-translate-hyphens-when-comment-region + �̈�R�����g�A�E�g������Ƃ��Ɋ��ɑ��݂���n�C�t���� `-' �ɕύX�� + �邩�ǂ����B(`t') + + -- Variable: yahtml-entity-reference-chars-alist + �G���e�B�e�B�Q��(Entity Reference)�ŋL�q���ׂ������Q��`'(?���� . "�G + ���e�B�e�B�\�L")' �Ƃ����`�������alist�ŕ��ׂ�B�f�t�H���g�� + `<', `>', `&', `'', `"' �ɑ���alist���ݒ肳��Ă���̂ŁA�lj������� + ���������L�q����Ηǂ��Bcdr�� `"�G���e�B�e�B�\�L"' �́A�擪�� `&' �� + ������`;' �͊܂߂��ɏ����B + + -- Variable: yahtml-faithful-to-htmllint + �\���`�F�b�J�Ƃ��� htmllint �𗘗p����ꍇ������Ƃ����]�v�ȋȂ� + �ɑ��Ă��x���������̂ŁA������������Ƃ��ɂ͂��̕ϐ���`t'�ɂ���B + + -- Variable: yahtml-use-css + CSS�̕⊮�@�\���g�����ǂ��� (`t') + + -- Variable: yahtml-image-inspection-bytes + �摜�t�@�C���̃T�C�Y�ׂ�Ƃ��ɓǂݍ��ރo�C�g�� (`10000') + + -- Variable: yahtml:img-default-alt-format + ��ALT�����̃f�t�H���g������̏����B%x�͉摜�̕��A%y�͉摜 + �̍����A%s�̓t�@�C���T�C�Y�ɒu������� (`"%xx%y(%sbytes)"') + + -- Variable: yahtml-escape-chars + href�⊮�Ȃǂ̂Ƃ��ɗ\����URL�G���R�[�h���邩; 'ask�̂Ƃ��͊m�F�� + �Ă���u������ (`'ask') + + -- Variable: yahtml-use-font-lock + �\�[�X�̐F�Â��p�b�P�[�W�Ƃ��� font-lock �𗘗p���邩(`(featurep + 'font-lock)') + + -- Variable: yahtml-use-hilit19 + �\�[�X�̐F�Â��p�b�P�[�W�Ƃ��� hilit19 �𗘗p���邩(`(featurep + 'hilit19)') + + -- Variable: yahtml-indentation-boundary + �C���f���g�v�Z��ł����Ă悢���E�ƂȂ鐳�K�\��(`"^\\s *"') + + + +File: yahtmlj, Node: Hook variables, Prev: All customizable variables, Up: Customizations + +hook�ϐ� +======== + + + + +File: yahtmlj, Node: Copying, Next: Concept Index, Prev: Customizations, Up: Top + +��舵�� +******** + + �{�v���O�����̓t���[�\�t�g�E�F�A�ł��B�{�v���O�������g�p���Đ����������� +�錋�ʂɑ��Ă���҂͐ӔC��Ȃ����ƂƂ��܂��B�]�ړ��Ɋւ��Ă͐������� +���܂���B�펯�I�Ɉ����Ă��������B�܂��A�g�p���Ă���|�����C���ł��m�点�� +�������ƁA��҂͊��ŃT�|�[�g�ɗ�ނ��Ƃł��傤�B + + ���A��]�A�o�O�A���z���͊��}�������܂��B�A���� yuuji@yatex.org �� +��(2000�N12������)�B�p���I�Ɏg�p���Ă���������̓��C�����O���X�g�ufj�쒹�� +��v�ɐ���������Ă��������B�������@�ɂ��Ă͖{�p�b�P�[�W�� `docs/htmlqa' +�t�@�C���́u���̑��v�̏͂��䗗���������B + +�d�l�́A�\���Ȃ��m����(�C�������)�ύX����܂�:-p�B + + �L���Y�� + + + + +File: yahtmlj, Node: Concept Index, Prev: Copying, Up: Top + +���� +**** + +* Menu: + +* �J�X�^�}�C�Y[�������܂���]: Customizations. 4. +* �L�[�A�T�C��[������������]: Customizations. 4. +* Demacs: Intro. 4. +* HTML��[HTML��]: Intro. 4. +* LaTeX: Intro. 4. +* Mule: Intro. 4. + + + + +Tag table: +Node: Top151 +Node: Intro620 +Node: Installation899 +Node: yahtml�N���̂��߂̐ݒ�1087 +Node: lint�v���O����/�u���E�U/�C���[�W�����[�A�����̐ݒ�1741 +Node: WWW�y�[�W���p�ϐ��̐ݒ�2241 +Node: Command Invocation3012 +Node: Completion3339 +Node: Jump4323 +Node: Changing and Deleting4722 +Node: �^�O�̕ύX4896 +Node: �����Q�Ƃւ̕ύX5246 +Node: ���W������������URLencode5629 +Node: td����/tr����5863 +Node: CSS Support6492 +Node: CSS-class completion6690 +Node: Reread CSS file7674 +Node: Customizations7896 +Node: All customizable variables8120 +Node: Hook variables11118 +Node: Copying11230 +Node: Concept Index11733 + +End tag table diff --git a/docs/yahtmlj.tex b/docs/yahtmlj.tex index e53ddef..a82e8c0 100644 --- a/docs/yahtmlj.tex +++ b/docs/yahtmlj.tex @@ -5,7 +5,7 @@ @iftex @c @syncodeindex fn cp -@c Last modified Wed Feb 29 09:18:14 2012 on firestorm +@c Last modified Thu May 10 11:13:11 2012 on firestorm @syncodeindex vr cp @end iftex @@ -15,7 +15,7 @@ @subtitle Yet Another html-mode for emacs @title �wHTML���x @subtitle // yahtml // -@author @copyright{} 1994-1997 by HIROSE, Yuuji [yuuji@@yatex.org] +@author @copyright{} 1994-2012 by HIROSE, Yuuji [yuuji@@yatex.org] @end titlepage @node Top, Intro, (dir), (dir) diff --git a/docs/yatexe b/docs/yatexe index 9d700e5..302390c 100644 --- a/docs/yatexe +++ b/docs/yatexe @@ -1,2219 +1,2242 @@ -Info file: yatexe, -*-Text-*- -produced by `texinfo-format-buffer' -from file `yatexe.tex' -using `texinfmt.el' version 2.38 of 3 July 1998. - - - - - - -File: yatexe, Node: Top, Next: What is YaTeX?, Prev: (dir), Up: (dir) - -* Menu: - -* What is YaTeX?:: -* Main features:: What YaTeX can do -* Installation:: Guide to install -* Typesetting:: Call typesetting processes -* %#notation:: Meta-keyword `%#' -* Completion:: Input LaTeX commands with completion -* Local dictionaries:: Directory dependent completion -* Commenting out:: Commenting/uncommenting text -* Cursor jump:: Jumping to related position -* Changing and Deleting:: Changing/deleting certain unit of text -* Filling:: Filling an item or paragraph -* Updation of includeonly:: Free from maintaining includeonly -* What column:: Check what table-column the cursor belong -* Intelligent newline:: Guess requisites of new line -* Usepackage checker:: Selecting correct \usepackage is YaTeX's job -* Online help:: On-line documentation of LaTeX -* Browsing file hierarchy:: Walking through file hierarchy -* Cooperation with other packages:: Work well with gmhist, min-out -* Customizations:: How to breed `Wild Bird' -* Etcetera:: YaTeX is acquisitive. -* Copying:: Redistribution - - - - -File: yatexe, Node: What is YaTeX?, Next: Main features, Prev: Top, Up: Top - -What is YaTeX? -************** - - YaTeX automates typesetting and previewing of LaTeX and enables -completing input of LaTeX mark-up command such as -`\begin{}'..`\end{}'. - - YaTeX also supports Demacs which runs on MS-DOS(386), Mule (Multi -Language Enhancement to GNU Emacs), and latex on DOS. - - - -File: yatexe, Node: Main features, Next: Installation, Prev: What is YaTeX?, Up: Top - -Main features -************* - - * Invocation of typesetter, previewer and related programs(`C-c t') - * Typesetting on static region which is independent from point - * Semiautomatic replacing of `\includeonly' - * Jumping to error line(`C-c '') - * Completing-read of LaTeX commands such as `\begin{}', - `\section' etc. - (`C-c b', `C-c s', `C-c l', `C-c m') - * Enclosing text into LaTeX environments or commands - (`C-u' ABOVEKEYSTROKES) - * Displaying the structure of text at entering sectioning commands - * Lump shifting of sectioning commands (*Note view-sectioning::) - * Learning unknown/new LaTeX commands for the next completion - * Argument reading with a guide for complicated LaTeX commands - * Generating argument-readers for new/unsupported commands(`yatexgen') - * Quick changing or deleting of LaTeX commands(`C-c c', `C-c k') - * Jumping from and to inter-file, begin<->end, ref<->label(`C-c g') - * Blanket commenting out or uncommenting - (`C-c >', `C-c <', `C-c ,', `C-c .') - * Easy input of accent mark, math-mode's commands and Greek letters - (`C-c a', `;', `:') - * Online help for the popular LaTeX commands - (`C-c ?', `C-c /') - * Document files hierarchy browser (`C-c d') - * Adding automatically \usepackage corresponding to inputting LaTeX - macro with completion - * Allow you to forget creating \label{}s, \ref or \cite completion - automatically generate labels. - - - -File: yatexe, Node: Installation, Next: Typesetting, Prev: Main features, Up: Top - -Installation -************ - - Put next two expressions into your `~/.emacs'. - - (setq auto-mode-alist - (cons (cons "\\.tex$" 'yatex-mode) auto-mode-alist)) - (autoload 'yatex-mode "yatex" "Yet Another LaTeX mode" t) - -Next, add certain path name where you put files of YaTeX to your -load-path. If you want to put them in `~/src/emacs', write - - (setq load-path - (cons (expand-file-name "~/src/emacs") load-path)) - -in your `~/.emacs' - - Then, yatex-mode will be automatically loaded when you visit a -file which has extension `.tex'. If yatex-mode is successfully -loaded, mode string on mode line will be turned to "YaTeX". - - - - -File: yatexe, Node: Typesetting, Next: %#notation, Prev: Installation, Up: Top - -Typesetting -*********** - - The prefix key stroke of yatex-mode is `C-c' (Press 'C' with Control -key) by default. If you don't intend to change the prefix key stroke, -assume all `[prefix]' as `C-c' in this document. These key -strokes execute typeset or preview command. - -`[prefix] t j' - ... invoke latex -`[prefix] t r' - ... invoke latex on region -`[prefix] t e' - ... invoke latex on current environment or whole - portion of current formulas in math-mode. -`[prefix] t k' - ... kill current typesetting process -`[prefix] t b' - ... invoke bibtex -`[prefix] t i' - ... invoke makeindex -`[prefix] t d' - ... invoke latex && dvipdfmx -`[prefix] t p' - ... preview -`[prefix] t l' - ... lpr dvi-file -`[prefix] t s' - ... search current string on xdvi-remote - -* Menu: - -* Calling typesetter:: -* Calling previewer:: -* Printing out:: - - - -File: yatexe, Node: Calling typesetter, Next: Calling previewer, Prev: Typesetting, Up: Typesetting - -Calling typesetter -================== - - Typing `[prefix] t j', the current editing window will be divided -horizontally when you invoke latex command, and log message of LaTeX -typesetting will be displayed in the other window; called typesetting -buffer. The typesetting buffer automatically scrolls up and traces LaTeX -warnings and error messages. If you see latex stopping by an error, you -can send string to latex in the typesetting buffer. - - If an error stops the LaTeX typesetting, this key stroke will move the -cursor to the line where LaTeX error is detected. - -`[prefix] '' -`([prefix]+single quotation)' - - ... jump to the previous error or warning - - If you find a noticeable error, move to the typesetting buffer and move -the cursor on the line of error message and type `SPACE' key. This makes -the cursor move to corresponding source line. - - YaTeX-typeset-region invoked by `[prefix] tr' call typesetter for -region. The region is specified by standard point and mark, or by -`%#BEGIN' and `%#END' marks. Selected region will be copied to the -temporary file `texput.tex' with the same preamble as the main file of -current editing sources. Be sure to put all local macro settings in -preamble, not after `\begin{document}'. The method of specification of -the region is shown in the section *Note %#notation::. - - The documentclass for typeset-region is the same as that of editing file -if you edit one file, and is the same as main file's if you edit splitting -files. - - The `[prefix] te' key automatically marks current inner environment or -inner math mode and then call typeset-region with marked region. This is -convenient to quick view of current tabular environment or current editing -formulas. Keeping previewer window for `texput.dvi' is handy for -debugging. Since `[prefix] te' selects the inner-most environment as -region, it is not suitable for partial typesetting of doubly or more -composed environment. If you want to do partial typesetting for a nested -environment, use `[prefix] tr' for static-region, which is described in -the section *Note %#notation::. - - - -File: yatexe, Node: Calling previewer, Next: Printing out, Prev: Calling typesetter, Up: Typesetting - -Calling previewer -================= - - `[prefix] t p' invokes the TeX previewer. And if you are using -xdvi-remote, which can be controled from other terminals, `[prefix] t s' -enables you to search current string at the cursor on the running xdvi -window. - - - -File: yatexe, Node: Printing out, Prev: Calling previewer, Up: Typesetting - -Printing out -============ - - When you type `[preifx] t l', YaTeX asks you the range of dvi-printing -by default. You can skip this by invoking it with universal-argument as -follows: - - C-u [prefix] tl - - - -File: yatexe, Node: %#notation, Next: Completion, Prev: Typesetting, Up: Top - -%# notation -*********** - - You can control the typesetting process by describing `%#' notations in -the source text. - -* Menu: - -* Changing typesetter:: -* Splitting input files:: -* Static region for typesetting:: -* Lpr format:: -* Editing %# notation:: - - - -File: yatexe, Node: Changing typesetter, Next: Splitting input files, Prev: %#notation, Up: %#notation - -To change the `latex' command or to split a source text. -======================================================== - - To change the typesetting command, write - - %#!latex-big - -anywhere in the source text. This is useful for changing typesetter. - - - -File: yatexe, Node: Splitting input files, Next: Static region for typesetting, Prev: Changing typesetter, Up: %#notation - -Splitting input files -===================== - - And if you split the source text and edit subfile that should be -included from main text. - - %#!latex main.tex - -will be helpful to execute latex on main file from sub text buffer. Since -this command line after `%#!' will be sent to shell literally, next -description makes it convenient to use ghostview as dvi-previewer. - - %#!latex main ; dvi2ps main.dvi > main - -Note that YaTeX assumes the component before the last period of the last -word in this line as base name of the main LaTeX source. The `%f' -notation in this line is replaced by main file name, and `%r' replaced by -root name of main file name. If you specify `%f' or `%r', YaTeX always -ask you the name of main file at the first typesetting. - - To make best use of the feature of inter-file jumping by `[prefix] g' -(see *Note Cursor jump::), take described below into consideration. - - * You can put split texts in sub directory, but not in sub directory of - sub directory. - * In the main text, specify the child file name with relative path name - such as \include{chap1/sub}, when you include the file in a - sub-directory. - * In a sub-text, write `%#!latex main.tex' even if `main.tex' is in the - parent directory(not %#!latex ../main.tex). - - - -File: yatexe, Node: Static region for typesetting, Next: Lpr format, Prev: Splitting input files, Up: %#notation - -Static region -============= - - Typeset-region by `[prefix] tr' passes the region between point and mark -to typesetting command by default. But when you want to typeset static -region, enclose the region by `%#BEGIN' and `%#END' as follows. - - %#BEGIN - TheRegionYouWantToTypesetManyTimes - %#END - -This is the rule of deciding the region. - - 1. If there exists %#BEGIN before point, - - 1. If there exists %#END after %#BEGIN, - * From %#BEGIN to %#END. - - 2. If %#END does not exist after %#BEGIN, - * From %#BEGIN to the end of buffer. - - 2. If there does not exist %#BEGIN before point, - * Between point and mark(standard method of Emacs). - - It is useful to write `%#BEGIN' in the previous line of \begin and -`%#END' in the next line of \`end' when you try complex environment such -as `tabular' many times. It is also useful to put only `%#BEGIN' alone at -the middle of very long text. Do not forget to erase `%#BEGIN' `%#END' -pair. - - - -File: yatexe, Node: Lpr format, Next: Editing %# notation, Prev: Static region for typesetting, Up: %#notation - -Lpr format -========== - - Lpr format is specified by three Lisp variables. Here are the default -values of them. - -`(1)dviprint-command-format' - `"dvi2ps %f %t %s | lpr"' -`(2)dviprint-from-format' - `"-f %b"' -`(3)dviprint-to-format' - `"-t %e"' - - On YaTeX-lpr, `%s' in (1) is replaced by the file name of main text, -`%f' by contents of (2), %t by contents of (3). At these replacements, -`%b' in (2) is also replaced by the number of beginning page, `%e' in (3) -is replaced by the number of ending page. But `%f' and `%t' are ignored -when you omit the range of print-out by `C-u [prefix] tl'. - - If you want to change this lpr format temporarily, put a command such as -follows somewhere in the text: - - %#LPR dvi2ps %f %t %s | 4up -page 4 | texfix | lpr -Plp2 - - And if you want YaTeX not to ask you the range of printing out, the next -example may be helpful. - - %#LPR dvi2ps %s | lpr - - - -File: yatexe, Node: Editing %# notation, Prev: Lpr format, Up: %#notation - -Editing %# notation -=================== - - To edit `%#' notation described above, type - -`[prefix] %' - ... editing %# notation menu - -and select one of the entry of the menu as follows. - - !)Edit-%#! B)EGIN-END-region L)Edit-%#LPR - -Type `!' to edit `%#!' entry, `b' to enclose the region with `%#BEGIN' and -`%#END', and `l' to edit `%#LPR' entry. When you type `b', all `%#BEGIN' -and `%#END' are automatically erased. - - - -File: yatexe, Node: Completion, Next: Local dictionaries, Prev: %#notation, Up: Top - -Completion -********** - - YaTeX makes it easy to input the LaTeX commands. There are several -kinds of completion type, begin-type, section-type, large-type, etc... - -* Menu: - -* Begin-type completion:: -* Section-type completion:: -* Large-type completion:: -* Maketitle-type completion:: -* Arbitrary completion:: -* End completion:: -* Accent completion:: -* Image completion:: -* Greek letters completion:: - - - -File: yatexe, Node: Begin-type completion, Next: Section-type completion, Prev: Completion, Up: Completion - -Begin-type completion -===================== - - "Begin-type completion" completes commands of `\begin{env}' ... -`\end{env}'. All of the begin-type completions begin with this key -sequence. - -`[prefix] b' - ... start begin-type completion - -An additional key stroke immediately completes a frequently used LaTeX -`\begin{}'...`\`end'{}' environment. - -`[prefix] b c' - ... `\begin{center}...\end{center}' -`[prefix] b d' - ... `\begin{document}...\end{document}' -`[prefix] b D' - ... `\begin{description}...\end{description}' -`[prefix] b e' - ... `\begin{enumerate}...\end{enumerate}' -`[prefix] b E' - ... `\begin{equation}...\end{equation}' -`[prefix] b i' - ... `\begin{itemize}...\end{itemize}' -`[prefix] b l' - ... `\begin{flushleft}...\end{flushleft}' -`[prefix] b m' - ... `\begin{minipage}...\end{minipage}' -`[prefix] b t' - ... `\begin{tabbing}...\end{tabbing}' -`[prefix] b T' - ... `\begin{tabular}...\end{tabular}' -`[prefix] b^T' - ... `\begin{table}...\end{table}' -`[prefix] b p' - ... `\begin{picture}...\end{picture}' -`[prefix] b q' - ... `\begin{quote}...\end{quote}' -`[prefix] b Q' - ... `\begin{quotation}...\end{quotation}' -`[prefix] b r' - ... `\begin{flushright}...\end{flushright}' -`[prefix] b v' - ... `\begin{verbatim}...\end{verbatim}' -`[prefix] b V' - ... `\begin{verse}...\end{verse}' - - Any other LaTeX environments are made by completing-read of the Emacs -function. - -`[prefix] b SPACE' - ... begin-type completion - -The next message will show up in the minibuffer - - Begin environment(default document): - -by typing `[prefix] b'. Put the wishing environment with completion in -the minibuffer, and `\begin{env}'...\`\end{env}' will be inserted in the -LaTeX source text. If the environment you want to put does not exist in -the YaTeX completion table, it will be registered in the user completion -table. YaTeX automatically saves the user completion table in the user -dictionary file at exiting of emacs. - -At the completion of certain environments, the expected initial entry will -automatically inserted such as `\item' for `itemize' environment. If you -don't want the entry, it can be removed by undoing. - - If you want to enclose some paragraphs which have already been written, -invoke the begin-type completion with changing the case of `b' of key -sequence upper(or invoke it with universal argument by `C-u' prefix). - - The following example encloses a region with `description' environment. - -`[prefix] B D' -`(or ESC 1 [prefix] b D)' -`(or C-u [prefix] b D)' - - ... begin-type completion for region - - This enclosing holds good for the completing input by `[prefix] b SPC'. -`[prefix] B SPC' enclose a region with the environment selected by -completing-read. - - - -File: yatexe, Node: Section-type completion, Next: Large-type completion, Prev: Begin-type completion, Up: Completion - -Section-type completion -======================= - - "Section-type completion" completes section-type commands which take an -argument or more such as `\section{foo}'. To invoke section-type -completion, type - -`[prefix] s' - ... section-type completion - -then the prompt - - (C-v for view) \???{} (default documentclass): - -will show up in the minibuffer. Section-type LaTeX commands are completed -by space key, and the default value is selected when you type nothing in -the minibuffer. - - Next, - - \section{???}: - -prompts you the argument of section-type LaTeX command. For example, the -following inputs - - \???{} (default documentclass): section - \section{???}: Hello world. - -will insert the string - - \section{Hello world.} - -in your LaTeX source. When you neglect argument such as - - (C-v for view) \???{} (default section): vspace* - \vspace*{???}: - -YaTeX puts - - \vspace*{} - -and move the cursor in the braces. - - In LaTeX command, there are commands which take more than one arguments -such as `\addtolength{\topmargin}{8mm}'. To complete these commands, -invoke section-type completion with universal argument as, - - C-u 2 [prefix] s (or ESC 2 [prefix] s) - -and make answers in minibuffer like this. - - (C-v for view) \???{} (default vspace*): addtolength - \addtolength{???}: \topmargin - Argument 2: 8mm - -`\addtolength' and the first argument `\topmargin' can be typed easily by -completing read. Since YaTeX also learns the number of arguments of -section-type command and will ask that many arguments in future -completion, you had better tell the number of arguments to YaTeX at the -first completion of the new word. But you can change the number of -arguments by calling the completion with different universal argument -again. - - - Invoking section-type completion with `[Prefix] S' (Capital `S') -includes the region as the first argument of section-type command. - - The section/large/maketitle type completion can work at the prompt for -the argument of other section-type completion. Nested LaTeX commands are -efficiently read with the recursive completion by typing YaTeX's -completion key sequence in the minibuffer. - -* Menu: - -* view-sectioning:: - - - -File: yatexe, Node: view-sectioning, Prev: Section-type completion, Up: Section-type completion - -view-sectioning ---------------- - - In the minibuffer at the prompt of section-type command completion, -typing `C-v' shows a list of sectioning commands in source text(The line -with `<<--' mark is the nearest sectioning command). Then, default -sectioning command appears in the minibuffer. You can go up/down -sectioning command by typing `C-p'/`C-n', can scrolls up/down the listing -buffer by `C-v'/`M-v', and can hide sectioning commands under certain -level by 0 through 6. Type `?' in the minibuffer of sectioning prompt -for more information. - - You can generate this listing buffer (`*Sectioning Lines*' buffer) by -typing -`M-x YaTeX-section-overview' - ... Generate *Sectioning Lines* buffer - -from the LaTeX source buffer. In this listing buffer, typing `u' on the -sectioning command shifts up the corresponding sectioning command in -source text and `d' shifts down. After marking lines in the listing -buffer, typing `U' shifts up all sectioning commands in the region, and -`U' shifts down. Here are all the key bindings of `*Sectioning Lines*' -buffer. - -`SPC' - ... Jump to corresponding source line -`.' - ... Display corresponding source line -`u' - ... Shift up a sectioning line -`d' - ... Shift down a sectioning line -`U' - ... Shift up sectioning lines in region -`D' - ... Shift down sectioning lines in region -`0...6' - ... Hide sectioning commands whose level is lower than n - - - - -File: yatexe, Node: Large-type completion, Next: Maketitle-type completion, Prev: Section-type completion, Up: Completion - -Large-type completion -===================== - - "Large-type completion" inputs the font or size changing descriptions -such as `{\large }'. When you type - -`[prefix] l' - ... large-type completion - -the message in the minibuffer - - {\??? } (default large): - -prompts prompts you large-type command with completing-read. There are -TeX commands to change fonts or sizes, `it', `huge' and so on, in the -completion table. - - Region-based completion is also invoked by changing the letter after -prefix key stroke as `[prefix] L'. It encloses the region by braces with -large-type command. - - - -File: yatexe, Node: Maketitle-type completion, Next: Arbitrary completion, Prev: Large-type completion, Up: Completion - -Maketitle-type completion -========================= - - We call it "maketitle-type completion" which completes commands such as -`\maketitle'. Take notice that maketitle-type commands take no arguments. -Then, typing - -`[prefix] m' - ... maketitle-type completion - -begins maketitle-completion. Above mentioned method is true for -maketitle-completion, and there are LaTeX commands with no arguments in -completion table. - - - -File: yatexe, Node: Arbitrary completion, Next: End completion, Prev: Maketitle-type completion, Up: Completion - -Arbitrary completion -==================== - - You can complete certain LaTeX command anywhere without typical -completing method as described, by typing - -`[prefix] SPC' - ... arbitrary completion - -after the initial string of LaTeX command that is preceded by `\'. - - - -File: yatexe, Node: End completion, Next: Accent completion, Prev: Arbitrary completion, Up: Completion - -End completion -============== - - YaTeX automatically detects the opened environment and close it with -\`\end{environment}'. Though proficient YaTeX users never fail to make -environment with begin-type completion, some may begin an environment -manually. In that case, type - -`[prefix] e' - ... `end' completion - -at the end of the opened environment. - - - -File: yatexe, Node: Accent completion, Next: Image completion, Prev: End completion, Up: Completion - -Accent completion -================= - - When you want to write the European accent marks(like `\`{o}'), - -`[prefix] a' - ... accent completion - -shows the menu - - 1:` 2:' 3:^ 4:" 5:~ 6:= 7:. u v H t c d b - -in the minibuffer. Chose one character or corresponding numeric, and you -will see - - \`{} - -in the editing buffer with the cursor positioned in braces. Type one more -character `o' for example, then - - \`{o} - -will be completed, and the cursor gets out from braces. - - - -File: yatexe, Node: Image completion, Next: Greek letters completion, Prev: Accent completion, Up: Completion - -Image completion of mathematical sign -===================================== - - Arrow marks, sigma mark and those signs mainly used in the TeX's math -environment are completed by key sequences which imitate the corresponding -symbols graphically. This completion only works in the math environment. -YaTeX automatically detects whether the cursor located in math environment -or not, and change the behavior of key strokes `;' and `:'. - - By the way, we often express the leftarrow mark by `<-' for example. -Considering such image, you can write `\leftarrow' by typing `<-' after -`;' (semicolon) as a prefix. In the same way, `\longleftarrow' (`<--') is -completed by typing `;<--', infinity mark which is imitated by `oo' is -completed by typing `;oo'. - - Here are the sample operations in YaTeX math-mode. - - INPUT Completed LaTeX commands - ; < - `\leftarrow' - ; < - - `\longleftarrow' - ; < - - > `\longleftrightarrow' - ; o `\circ' - ; o o `\infty' - - In any case, you can quit from image completion and can move to the next -editing operation if the LaTeX command you want is shown in the buffer. - - `;' itself in math-environment is inserted by `;;'. Typing `TAB' in the -midst of image completion shows all of the LaTeX commands that start with -the same name as string you previously typed in. In this menu buffer, -press `RET' after moving the cursor (by `n', `p', `b', `f') to insert the -LaTeX command. - - To know all of the completion table, type `TAB' just after `;'. And -here is the sample menu by `TAB' after `;<'. - - KEY LaTeX sequence sign - < \leq < - ~ - << \ll << - <- \leftarrow <- - <= \Leftarrow <= - - You can define your favorite key-vs-sequence completion table in the -Emacs-Lisp variable `YaTeX-math-sign-alist-private'. See also -`yatexmth.el' for the information of the structure of this variable. - - - -File: yatexe, Node: Greek letters completion, Prev: Image completion, Up: Completion - -Greek letters completion -======================== - - Math-mode of YaTeX provides another image completion, Greek letters -completion in the same method. After prefix `:', typing `a' makes -`\alpha', `b' makes `\beta' and `g' makes `\gamma' and so on. First, type -`:TAB' to know all the correspondence of alphabets vs. Greek letters. - - If you will find `;' or `:' doesn't work in correct position of math -environment, it may be a bug of YaTeX. Please send me a bug report with -the configuration of your text, and avoid it temporarily by typing `;' or -`:' after universal-argument(`C-u') which forces `;' and `:' to work as -math-prefix. - - - -File: yatexe, Node: Local dictionaries, Next: Commenting out, Prev: Completion, Up: Top - -Local dictionaries -****************** - - Tables for completion consist of three dictionaries; `standard -dictionary' built in `yatex.el', `user dictionary' for your common private -commands, and `local dictionary' that is effective in a certain directory. - - When you input the command unknown to YaTeX at a completion in the -minibuffer, YaTeX asks you with the following prompt; - - `foo' is not in table. Register into: U)serDic L)ocalDic N)one D)iscard - -In this menu, typing `u' updates your `user dictionary', `l' updates your -local dictionary, `n' updates only on-memory dictionary which go through -only current Emacs session, and `d' updates no dictionary and throws the -new word away. - - If you find this switching feature meaningless and bothersome, put the -next expression into your `~/.emacs' - - (setq YaTeX-nervous nil) - - - -File: yatexe, Node: Commenting out, Next: Cursor jump, Prev: Local dictionaries, Up: Top - -Commenting out -************** - - You may want to comment out some region. - -`[prefix] >' - ... comment out region by % -`[prefix] <' - ... uncomment region - -cause an operation to the region between point and mark. - -`[prefix] .' - ... comment out current paragraph -`[prefix] ,' - ... uncomment current paragraph - -comments or uncomments the paragraph where the cursor belongs. This -`paragraph' means the region marked by the function mark-paragraph, bound -to `ESC h' by default. It is NOT predictable what will happen when you -continuously comment out some paragraph many times. - - You can also comment out an environment between `\begin' and `\end', or -a `\begin'-\`\end' pair themselves, by making the following key strokes on -the line where `\begin{}' or `\end{}' exists. - -`[prefix] >' - ... comment out from \begin to \`end' -`[prefix] <' - ... uncomment from \begin to \`end' - -comment whole the contents of environment. Moreover, - -`[prefix] .' - ... comment out \begin and \`end' -`[prefix] ,' - ... uncomment \begin and \`end' - -(un)comments out only environment declaration: `\begin{}' and `\end{}'. -NOTE that even if you intend to comment out some region, invoking -`[prefix] >' on the `\begin',`\end' line decides to work in `commenting -out from `\begin' to `\end'' mode. - - - - -File: yatexe, Node: Cursor jump, Next: Changing and Deleting, Prev: Commenting out, Up: Top - -Cursor jump -*********** - - -* Menu: - -* Jump to corresponding object:: -* Invoking image processor:: -* Jump to main file:: -* Jumping around the environment:: -* Jumping to last completion position:: - - - -File: yatexe, Node: Jump to corresponding object, Next: Invoking image processor, Prev: Cursor jump, Up: Cursor jump - -Jump to corresponding object -============================ - - Typing - -`[prefix] g' - ... go to corresponding object - -in a certain place move the cursor to the place corresponding to the LaTeX -command of last place. YaTeX recognize the followings as pairs that have -relation each other. - - * `\begin{}' <-> `\end{}' - * `%#BEGIN' <-> `%#END' - * On the image-including line -> corresponding viewer or drawing tool - * `\label{}' <-> `\ref{}' - * `\include(\input)' -> included file - * `\bibitem{}' <-> `\cite{}' - - On a `\begin',`\end' line, typing `[prefix] g' moves the cursor to the -corresponding `\end',`\begin' line, if its partner really exists. The -behavior on the line `%#BEGIN' and `%#END' are the same. Note that if the -correspondent of `label/ref' or `cite/bibitem' exists in another file, -that file have to be opened to make a round trip between references by -`[prefix] g'. - - If you type `[prefix] g' on the line of `\include{chap1}', typically in -the main text, YaTeX switches buffer to `chap1.tex'. - -`[prefix] 4 g' - ... go to corresponding object in other window - -do the same job as `[prefix] g' except it's done in other window. Note -that this function doesn't work on `begin/end', `%#BEGIN/%#END' pairs -because it is meaningless. - - - -File: yatexe, Node: Invoking image processor, Next: Jump to main file, Prev: Jump to corresponding object, Up: Cursor jump - -Invoking image processor -======================== - - -`image-including line' described above means such lines as -`\epsfile{file=foo.ps}'. If you type `[prefix] g' on that line, YaTeX -automatically searches source of `foo.ps' and invokes image viewer or -drawing tool correspoinding to it. For example; if you draw an image -foo.obj with Tgif and enclose its product named foo.eps by `\epsfile' -command. Typing `[prefix] g' on `\epsfile' line make YaTeX invoke `tgif -foo.obj'. How a processor is choosen is as follows. - - 1. If there is an expression matching with one of the pattern defined in - `YaTeX-processed-file-regexp-alist', extract file name from regexp - group surrounded by \\(\\). (Which group corresponds is written in - the cdr part of each list.) If no matches were found, do nothing. - 2. If there is a pattern as `%PROCESSOR' which is defined in the - variable `YaTeX-file-processor-alist', call that processor giving the - file name with corresponding extension. - 3. If not, check the existence of each file which is supplied the - extension in the cdr part of each list of - `YaTeX-file-processor-alist'. If any, call the corresponding image - viewer or drawing tool. - - - -File: yatexe, Node: Jump to main file, Next: Jumping around the environment, Prev: Invoking image processor, Up: Cursor jump - -Jump to main file -================= - - Typing - -`[prefix] ^' - ... visit main file -`[prefix] 4^' - ... visit main file in other buffer - -in a sub text switch the buffer to the main text specified by `%#!' -notation. - - - -File: yatexe, Node: Jumping around the environment, Next: Jumping to last completion position, Prev: Jump to main file, Up: Cursor jump - -Jumping around the environment -============================== - - And these are the functions which work on the current LaTeX environment: - -`M-C-a' - ... beginning of environment -`M-C-e' - ... `end' of environment -`M-C-@' - ... mark environment - - - -File: yatexe, Node: Jumping to last completion position, Prev: Jumping around the environment, Up: Cursor jump - -Jumping to last completion position -=================================== - -YaTeX always memorize the position of completion into register `3'. So -every time you make a trip to any other part of text other than you are -writing, you can return to the editing paragraph by calling -register-to-point with argument YaTeX-current-position-register, which is -achieved by typing `C-x j 3'(by default). - - - -File: yatexe, Node: Changing and Deleting, Next: Filling, Prev: Cursor jump, Up: Top - -Changing and Deleting -********************* - - These functions are for change or deletion of LaTeX commands already -entered. - -`[prefix] c' - ... change LaTeX command -`[prefix] k' - ... kill LaTeX command - -* Menu: - -* Changing LaTeX commands:: -* Killing LaTeX commands:: - - - -File: yatexe, Node: Changing LaTeX commands, Next: Killing LaTeX commands, Prev: Changing and Deleting, Up: Changing and Deleting - -Changing LaTeX commands -======================= - -`[prefix] c' can change the various (La)TeX commands. This can change the -followings. - * Environment names - * Section-type commands - * Argument of section-type commands - * Optional parameters (enclosed by []) of section-type commands - * Font/size designators - * Math-mode's maketitle-type commands that can be inputted with image - completion - - Typing `[prefix] c' on one of above objects you want to change brings a -suitable reading function sometimes with completion. Note: If you want to -change the argument of section-type command that contains other LaTeX -commands, type `[prefix] c' either of surrounding braces of the argument -in order to make YaTeX ignore the internal LaTeX sequences as an object of -changing. Anyway, it is very difficult to know which argument position -the cursor belongs because the LaTeX commands can be nested and braces can -freely emerge. So keep it mind to put the cursor on a brace when you are -thinking of changing a complicated argument. - - - -File: yatexe, Node: Killing LaTeX commands, Prev: Changing LaTeX commands, Up: Changing and Deleting - -Killing LaTeX commands -====================== - - `[prefix] k' kills the LaTeX commands sometimes with their arguments. -Following table illustrates the correspondence of the invoking position -and what is killed. - - [Invoking position] [action] - \begin, \end line kill \begin,\end pairs - %#BEGIN, %#END line kill %#BEGIN,%#END pairs - on a Section-type command kill section-type command - on a parenthesis kill parentheses - -Note that when killing `\begin, \end' or `%#BEGIN, %#END' pair, the lines -`\begin, \end' or `%#BEGIN, %#END' exist will be killed entirely. So take -care not to create any line that contains more than one `\begin' or so. - -While all operations above are to kill `containers' which surround some -text, universal argument (`C-u') for these commands kills not only -`containers' but also `contents' of them. See below as a sample. - - Original text: [prefix] k C-u [prefix] k - Main \footnote{note} here. Main note here. Main here. - ~(cursor) - - - -File: yatexe, Node: Filling, Next: Updation of includeonly, Prev: Changing and Deleting, Up: Top - -Filling -******* - - -Filling an item -=============== - - To fill a term (descriptive sentences) of `\item', type - -`M-q' - ... fill item - -on that item. - - YaTeX uses the value of the variable `YaTeX-item-regexp' as the regular -expression to search item header in itemize environment. If you make a -newcommand to itemize terms(e.g. `\underlineitem'), put - - (setq YaTeX-item-regexp - "\\(\\\\\\(sub\\)*item\\)\\|\\(\\\\underlineitem\\)") - -in your `~/.emacs'. If you are not familiar with regular expression for -Emacs-Lisp, name a newcommand for `itemize' beginning with `\item' such as -`\itembf', not `\bfitem'. - - This function reformats the `\item' into `hang-indented' style. For -example: - - itemize, enumerate environment: - > - >\item[foo] `foo' is the typical word for describing an - > arbitrarily written.... - description environment: - > \item[bar] When the word `for' is used as an arbitrarily - > word, `bar' is bound to follow it. - - Note that the indent depth of an `\item' word and its descriptive -paragraph are the same in latter case. If you want to use different -depth, invoke fill-paragraph at the beginning of non-whitespace -character(see below). - - -Filling paragraph -================= - - Fill-paragraph is little bit adapted for LaTeX sources. It retains from -filling in certain environments where formatting leads to a disaster such -as verbatim, tabular, or so. And it protects `\verb' expressions from -being folded (The variable `YaTeX-verb-regexp' controls this). Besides, -putting cursor on the first occurrence of non-whitespace character on a -line changes the fill-prefix temporarily to the depth of the line. - - - -File: yatexe, Node: Updation of includeonly, Next: What column, Prev: Filling, Up: Top - -Updation of `\includeonly' -************************** - - When you edit splitting source texts, the notation - - \includeonly{CurrentEditingFileName} - -in the main file reduces the time of typesetting. If you want to hack -other file a little however, you have to rewrite it to - - \includeonly{OtherFileNameYouWantToFix} - -in the main file. YaTeX automatically detects that the current edited -text is not in includeonly list and prompts you - - A)dd R)eplace %)comment? - -in the minibuffer. Type `a' if you want to add the current file name to -`\includeonly' list, `r' to replace \`includeonly' list with the current -file, and type `%' to comment out the `\includeonly' line. - - - -File: yatexe, Node: What column, Next: Intelligent newline, Prev: Updation of includeonly, Up: Top - -What column? -************ - - We are often get tired of finding the corresponding column in large -tabulars. For example, - - \begin{tabular}{|c|c|c|c|c|c|c|c|}\hline - Name&Position&Post No.&Addr.&Phone No.&FAX No.& - Home Addr.&Home Phone\\ \hline - Thunder Bird & 6 & 223 & LA & xxx-yyy & - zzz-www & Japan & 9876-54321 \\ - & 2 & \multicolumn{2}{c|}{Unknown} - &&&(???) - \\ \hline - \end{tabular} - -Suppose you have the cursor located at `(???)' mark, can you tell which -column it is belonging at once? Maybe no. In such case, type - -`[prefix] &' - ... What column - -in that position. YaTeX tells you the column header of the current field. -Since YaTeX assumes the first line of tabular environment as a row of -column headers, you can create a row of virtual column headers by putting -them in the first line and commenting that line with `%'. - - - -File: yatexe, Node: Intelligent newline, Next: Usepackage checker, Prev: What column, Up: Top - -Intelligent newline -******************* - - At the end of begin-type completion of tabular[*], array, itemize, -enumerate or tabbing environment, or typing - -`ESC RET' - ... Intelligent newline - -in these environments inserts the contents corresponding to the current -environment in the next line. (At the begin-type completion, this -contents can be removed by `undo'.) In `tabular' environment, for -example, `ESC RET' inserts the certain number of `&' and trailing `\\', -and `\hline' if other `\hline' is found in backward. Here are the list of -contents vs. environments. - - * `tabular', `tabular*', `array' - - Corresponding number of `&' and `\\'. And `\hline' if - needed. - - * `tabbing' - - The same number of `\>' as `\=' in the first line. - - * `itemize', `enumerate', `description', `list' - - `\item' or `item[]'. - - Note that since this function works seeing the contents of the first -line, please call this after the second line if possible. - - If you want to apply these trick to other environments, `foo' -environment for example, define the function named -`YaTeX-intelligent-newline-foo' to insert corresponding contents. That -function will be called at the beginning of the next line after the -newline is inserted to the current line. Since the function -`YaTeX-indent-line' is designed to indent the current line properly, -calling this function before your code to insert certain contents must be -useful. See the definition of the function -`YaTeX-intelligent-newline-itemize' as an example. - - - -File: yatexe, Node: Usepackage checker, Next: Online help, Prev: Intelligent newline, Up: Top - -Usepackage checker -****************** - -When you input begint-type, section-type, maketitle-type macros with -completion, and it requires some LaTeX2e package, YaTeX examines the -existence of correct `\usepackage'. If not, YaTeX inserts the -`\usepackage{}' declaration corresponding to input macro. - -To activate the package completion for your favarite package, set the -variable `YaTeX-package-alist-private' correctly. Please refere the value -of `YaTeX-package-alist-default' as an example. - - - -File: yatexe, Node: Online help, Next: Browsing file hierarchy, Prev: Usepackage checker, Up: Top - -Online help -*********** - - YaTeX provides you the online help with popular LaTeX commands. - - Here are the key strokes for the online help. - -`[prefix] ?' - ... Online help -`[prefix] /' - ... Online apropos - - -Online help -=========== - - `Online help' shows the documentation for the popular LaTeX -commands(defaults to the commands on the cursor) in the next buffer. -There are two help file, `global help' and `private help'. The former -file contains the descriptions on the standard LaTeX command and is -specified its name by variable `YaTeX-help-file'. Usually, the global -help file should be located in public space (`$EMACSEXECPATH' by default) -and should be world writable so that anyone can update it to enrich its -contents. The latter file contains descriptions on non-standard or -personal command definitions and is specified by -`YaTeX-help-file-private'. This file should be put into private -directory. - - -Online apropos -============== - - `Online apropos' is an equivalent of GNU Emacs's apropos. It shows all -the documentations that contains the keyword entered by the user. - - -When no descriptions are found... -================================= - - If there is no description on a command in help files, YaTeX requires -you to write a description on that command. If you are willing to do, -determine which help file to add and write the description on it referring -your manual of (La)TeX. Please send me your additional descriptions if -you describe the help on some standard commands. I might want to include -it in the next distribution. - - - -File: yatexe, Node: Browsing file hierarchy, Next: Cooperation with other packages, Prev: Online help, Up: Top - -Browsing file hierarchy -*********************** - - When you are editing multi-file source, typing - -`[prefix] d' - ... browse file hierarchy - -asks you the parent-most file (which may be defaulted) and displays the -documentation hierarchy in the next window. In this buffer, the following -commands are available. - -`n' - ... move to the next line and show its contents -`p' - ... move to the previous line and show its contents -`N' - ... move to the next file in the same inclusion level -`P' - ... move to the previous file in the same inclusion level -`j' - ... move to the next line -`k' - ... move to the previous line -`u' - ... move to the parent file -`.' - ... show the current files contents in the next window -`SPC' - ... scroll up the current file window -`DEL, b' - ... scroll down the current file window -`<' - ... show the beginning of the current file -`>' - ... show the end of the current file -`>' - ... return to the previous postion after `<' or `>' -`RET, g' - ... open the current file in the next window -`mouse-2' - ... same as RET(available only with window system) -`o' - ... other window -`1' - ... delete other windows -`-' - ... shrink hierarchy buffer window -`+' - ... enlarge hierarchy buffer window -`?' - ... describe mode -`q' - ... quit - - Note that operations on the file contents in the next window do not work -correctly when you close the corresponding file. - - - -File: yatexe, Node: Cooperation with other packages, Next: Customizations, Prev: Browsing file hierarchy, Up: Top - -Cooperation with other packages -******************************* - - YaTeX works better with other brilliant packages. - - -gmhist -====== - - When you are loading `gmhist.el' and `gmhist-mh.el', you can use -independent command history list at the prompt of preview command -(`[prefix] tp') and print command (`[prefix] tl'). On each prompt, you -can enter the previous command line string repeatedly by typing `M-p'. - - -min-out -======= - - `min-out', the outline minor mode, can be used in yatex-mode buffers. -If you want to use it with YaTeX, please refer the file `yatexm-o.el' as -an example. - - - -File: yatexe, Node: Customizations, Next: Etcetera, Prev: Cooperation with other packages, Up: Top - -Customizations -************** - - You can customize YaTeX by setting Emacs-Lisp variables and by making -add-in functions. - -* Menu: - -* Lisp variables:: -* Add-in functions:: -* Add-in generator:: - - - -File: yatexe, Node: Lisp variables, Next: Add-in functions, Prev: Customizations, Up: Customizations - -Lisp variables -============== - - You can change the key assignments or make completion more comfortable -by setting the values of various variables which control the movement of -yatex-mode. - - For example, if you want to change the prefix key stroke from `C-c' to -any other sequence, set YaTeX-prefix to whatever you want to use. If you -don't want to use the key sequence `C-c letter' which is assumed to be the -user reserved sequence in Emacs world, set `YaTeX-inhibit-prefix-letter' -to `t', and all of the default key bind of `C-c letter' will turn to the -corresponding `C-c C-letter' (but the region based completions that is -invoked with `C-c Capital-letter' remain valid, if you want to disable -those bindings, set that variable to 1 instead of `t'). - -* Menu: - -* All customizable variables:: -* Sample definitions:: -* Hook variables:: -* Hook file:: - - - -File: yatexe, Node: All customizable variables, Next: Sample definitions, Prev: Lisp variables, Up: Lisp variables - -All customizable variables --------------------------- - - Here are the customizable variables of yatex-mode. Each value setq-ed -in `~/.emacs' is preferred and that of defined in `yatex.el' is neglected. -Parenthesized contents stands for the default value. When you are to -change some of these variables, see more detailed documentation of the -variable by `M-x describe-variable'. - - -- Variable: YaTeX-japan - Set this nil to produce all messages in English (`Depends on Japanese - feature of Emacs') - - -- Variable: YaTeX-kanji-code - Default buffer-file-coding-system for YaTeX modes' buffer. Set this - 0 to no language conversion. Nil to preserve original - coding-system. 1=Shift JIS, 2=JIS, 3=EUC, 4=UTF-8 (`1 or 2') - - -- Variable: YaTeX-prefix - Prefix key stroke (`C-c') - - -- Variable: YaTeX-inhibit-prefix-letter - Change key stroke from `C-c letter' to `C-c C-letter' (`nil') - - -- Variable: YaTeX-fill-prefix - Fill-prefix used in yatex-mode (`nil') - - -- Variable: YaTeX-user-completion-table - Name of user dictionary where learned completion table will be - stored. (`"~/.yatexrc"') - - -- Variable: tex-command - LaTeX typesetter command (`"latex"') - - -- Variable: dvi2-command - Preview command (`"xdvi -geo +0+0 -s 4"') - - -- Variable: dviprint-command-format - Command format to print dvi file (`"dvi2ps %f %t %s | lpr"') - - -- Variable: dviprint-from-format - Start page format of above %f. %b will turn to start page (`"-f %b"') - - -- Variable: dviprint-to-format - End page format of above %t. %e will turn to `end' page (`"-t %e"') - - -- Variable: makeindex-command - Default makeindex command (`"makeindex"' (`"makeind"' on MS-DOS)) - - -- Variable: YaTeX-dvipdf-command - Default command name to convert .dvi to PDF (`"dvipdfmx"') - - -- Variable: YaTeX-need-nonstop - Put `\nonstopmode{}' or not (`nil') - - -- Variable: latex-warning-regexp - Regular expression of warning message latex command puts out - (`"line.* [0-9]*"') - - -- Variable: latex-error-regexp - Regular expression of error message (`"l\\.[1-9][0-9]*"') - - -- Variable: latex-dos-emergency-message - Message latex command running on DOS puts at abort (`"Emergency - stop"') - - -- Variable: YaTeX-item-regexp - Regular expression of item command (`"\\\\item"') - - -- Variable: YaTeX-verb-regexp - Regexp of verb family. Omit \\\\. (`"verb\\*?\\|path"') - - -- Variable: YaTeX-nervous - T for using local dictionary (`t') - - -- Variable: YaTeX-sectioning-regexp - Regexp of LaTeX sectioning command - (`"\\(part\\|chapter\\*?\\|\\(sub\\)*\\(section\\|paragraph\\)\\*?\\)\\b"') - - -- Variable: YaTeX-fill-inhibit-environments - Inhibit fill in these environments (`'("tabular" "tabular*" "array" - "picture" "eqnarray" "eqnarray*" "equation" "math" "displaymath" - "verbatim" "verbatim*")') - - -- Variable: YaTeX-uncomment-once - T for deleting all preceding `%' (`nil') - - -- Variable: YaTeX-close-paren-always - T for always close all parenthesis automatically, `nil' for only eol - (`t') - - -- Variable: YaTeX-auto-math-mode - Switch math-mode automatically (`t') - - -- Variable: YaTeX-math-key-list-private - User defined alist, math-mode-prefix vs completion alist used in - image completion (`nil'). See `yatexmth.el' for the information - about how to define a completion alist. - - -- Variable: YaTeX-default-pop-window-height - Initial height of typesetting buffer when one-window. Number for the - lines of the buffer, numerical string for the percentage of the - screen-height. `nil' for half height (10) - - -- Variable: YaTeX-help-file - Global online help file name - (`$doc-directory/../../site-lisp/YATEXHLP.eng') - - -- Variable: YaTeX-help-file-private - Private online help file name (`"~/YATEXHLP.eng"') - - -- Variable: YaTeX-no-begend-shortcut - Disable [prefix] b ?? shortcut (`nil)' - - -- Variable: YaTeX-hilit-pattern-adjustment-private - List of the list that contain the regular expression and the symbol - of logical meaning of the string that matches the pattern. See also - the value from `(assq 'yatex-mode hilit-patterns-alist)' and the - value of `YaTeX-hilit-pattern-adjustment-default' (and even the - document of hilit19.el). - - -- Variable: YaTeX-sectioning-level - Alist of LaTeX's sectioning command vs its height. - - -- Variable: YaTeX-hierarchy-ignore-heading-regexp - `YaTeX-display-hierarchy' searches for sectioning command first, and - comment line secondary as a file headings. In latter case, ignore lines - that match with regular expression of this variable. Default value of - this variable is RCS header expressions and mode specifying line `-*- xxxx - -*'. - - -- Variable: YaTeX-skip-default-reader - Non-nil for this variable skips the default argument reader of - section-type command when add-in function for it is not defined - (`nil') - - -- Variable: YaTeX-create-file-prefix-g - When typing `prefix g' on the `\include' line, open the target file - even if the file doesn't exist (`nil') - - -- Variable: YaTeX-simple-messages - Simplyfy messages of various completions (`nil') - - -- Variable: YaTeX-hilit-sectioning-face - When hilit19 and yatex19 is active, YaTeX colors the sectioning - commands. This variable specifies the foreground and background - color of `\part' macro. The default value is `'(yellow/dodgerblue - yellow/slateblue)'. The first element of this list is for the screen - when `hilit-background-mode' is `'light', and the second element is - for `'dark'. You should specify both color as `forecolor/backcolor'. - - -- Variable: YaTeX-hilit-sectioning-attenuation-rate - When color mode, this variable specifies how much attenuate the color - density of `\subparagraph' compared with that of `\chapter' (`'(15 - 40)') See also `YaTeX-hilit-sectioning-face'. - - -- Variable: YaTeX-use-AMS-LaTeX - If you use AMS-LaTeX, set to `t' (`nil') - - -- Variable: YaTeX-use-LaTeX2e - If you use LaTeX2e, set to `t' (`t') - - -- Variable: YaTeX-template-file - File name which is automatically inserted at creation - (`~/work/template.tex') - - -- Variable: YaTeX-search-file-from-top-directory - Non-nil means to search input-files from the directory where main - file exists (`t') - - -- Variable: YaTeX-use-font-lock - Use font-lock to fontify buffer or not (`(featurep 'font-lock)' - - -- Variable: YaTeX-use-hilit19 - Use hilit19 to highlight buffer or not (`(featurep 'hilit19)' - - -- Variable: YaTeX-use-italic-bold - YaTeX tries to search italic, bold fontsets or not (`t' if Emacs-20 - or later). This variable is effective only when font-lock is used. - (`(featurep 'hilit19)' - - -- Variable: YaTeX-singlecmd-suffix - Suffix which is always inserted after maketitle-type macros. `"{}"' - is recommended. - - -- Variable: YaTeX-package-alist-private - Alist of LaTeX2e-package name vs. lists of macros in it. Set this - alist properly and YaTeX automatically check the declaratiion of - `usepackage' for corresponding macro, when you input that macro with - completion. If required `usepackage' is not found, YaTeX also - automatically inserts `\usepackage'. Alist is as follows; - '((PackageName1 (completionType ListOfMacro) (completionType - ListOfMacro)) (PackageName2 (completionType ListOfMacro) - (completionType ListOfMacro...))....) completionType is one of `env, - section, maketitle'. Consult the value of - `YaTeX-package-alist-default' as an example. - - -- Variable: YaTeX-tabular-indentation - At indentation by `C-i' in tabular or array environment, YaTeX put - the additional spaces to the normail indentation depth. The number - of additional spaces is the product of YaTeX-tabular-indentation and - the number of column position in tabular. - - -- Variable: YaTeX-noindent-env-regexp - Regexp of environment names that should begin with no indentation. - All verbatime-like environment name should match with. - - -- Variable: YaTeX-ref-default-label-string - Default \\ref time string format. This format is like strftime(3) - but allowed conversion char are as follows; %y -> Last 2 digit of - year, %b -> Month name, %m -> Monthe number(1-12), %d -> Day, %H -> - Hour, %M -> Minute, %S -> Second, %qx -> alphabetical-decimal - conversion of yymmdd. %qX -> alphabetical-decimal conversion of - HHMMSS. Beware defualt label-string should be always unique. So - this format string should have both time part (%H+%M+%S or %qX) and - date part (%y+(%b|%m)+%d or %qx). - - -- Variable: YaTeX-ref-generate-label-function - Function to generate default label string for unnamed \\label{}s. - The function pointed to this value should take two arguments. First - argument is LaTeX macro's name, second is macro's argument. Here is - an example for using this value. - (setq YaTeX-ref-generate-label-function 'my-yatex-generate-label) - (defun my-yatex-generate-label (command value) - (and (string= command "caption") - (re-search-backward "\\\\begin{\\(figure\\|table\\)}" nil t) - (setq command (match-string 1))) - (let ((alist '(("chapter" . "chap") - ("section" . "sec") - ("subsection" . "subsec") - ("figure" . "fig") - ("table" . "tbl")))) - (if (setq command (cdr (assoc command alist))) - (concat command ":" value) - (YaTeX::ref-generate-label nil nil)))) - - - - -File: yatexe, Node: Sample definitions, Next: Hook variables, Prev: All customizable variables, Up: Lisp variables - -Sample definitions ------------------- - - For instance, to change the prefix key stroke to `ESC', and name of the -user dictionary `~/src/emacs/yatexrc', and set `fill-prefix' to single TAB -character, add the following `setq' to `~/.emacs'. - - (setq YaTeX-prefix "\e" - YaTeX-user-completion-table "~/src/emacs/yatexrc" - YaTeX-fill-prefix " ") - - - -File: yatexe, Node: Hook variables, Next: Hook file, Prev: Sample definitions, Up: Lisp variables - -Hook variables --------------- - - More customizations will be done by the hook-function defined in -hook-variable `yatex-mode-hook'. This is useful to define a shortcut key -sequence to enter some environments other than `document' and `enumerate' -etc. The following statement defines `[prefix] ba' to enter -`\begin{abstract}' ... `=end{abstract}' immediately. - - (setq yatex-mode-hook - '(lambda() (YaTeX-define-begend-key "ba" "abstract"))) - - You should use functions `YaTeX-define-key', or -`YaTeX-define-begend-key' to define all the key sequences of yatex-mode. - - - -File: yatexe, Node: Hook file, Prev: Hook variables, Up: Lisp variables - -Hook file ---------- - - You can stuff all of YaTeX related expressions into a file named -`yatexhks.el' if you have a lot of codes. YaTeX automatically load this -file at the initialization of itself. Using `yatexhks.el' makes -`yatex-mode-load-hook' unnecessary. - - - -File: yatexe, Node: Add-in functions, Next: Add-in generator, Prev: Lisp variables, Up: Customizations - -Add-in functions -================ - - You can easily define a function to input detailed arguments with -completion according to LaTeX environments or commands. - - -What is add-in functions? -------------------------- - - When you input `tabular' environment, don't you think "I want YaTeX to -complete its argument toward my favorite one such as `{|c|c|c|}'..."? -Yes, you can define the function to complete arguments for any environment -and any LaTeX commands. - - -Procedure ---------- - - Here is the procedure to define add-in functions. - 1. Define the function - 2. Put the function into `yatexhks.el' - -* Menu: - -* How the add-in function works:: -* How the function is called:: -* Useful functions for creating add-in:: -* Contribution:: - - - -File: yatexe, Node: How the add-in function works, Next: How the function is called, Prev: Add-in functions, Up: Add-in functions - -How the add-in function works ------------------------------ - -There are three types of add-in. - - 1. Option add-in - 2. argument add-in - 3. enclosing add-in - -"Option add-in" returns the LaTeX's optional parameters such as optional -strings after `\begin{ENV}', optional strings between a section-type -command and its first argument, and optional strings just after type -maketitle-type command. The following illustrates the name of add-in -functions, where underlined strings are generated by add-in functions. - - \begin{table}[ht] (Function name: YaTeX:table) - ~~~~ - \put(100,200){} (Function name: YaTeX:put) - ~~~~~~~~~ - \sum_{i=0}^{n} (Function name: YaTeX:sum) - ~~~~~~~~~~ - - Obviously, the function name is decided by concatenating the prefix -`YaTeX:' and LaTeX command's name. - - Another add-in type is "argument add-in", which completes arguments for -section-type commands. - - \newcommand{\foo}{bar} (Function name: YaTeX::newcommand) - ~~~~ ~~~ - - When the section-type command is inputted, the function named by -concatenating `YaTeX::' and section-type command, is called automatically -with an integer argument which indicates which argument of section-type -command is being read. Thus the add-in should determine the job referring -the value of its argument. - - "enclosing add-in" is for modifying and/or checking the region that will -be enclosed by section-type commands via `[prefix] S'. An enclosing -add-in function will be called with two arguments, beginning of the -enclosed region and end of the region. Suppose you want to enclose the -existing text `(a+b)/c' by `\frac{}'. - - a/c - | | - A B - -You do set-mark-command at point A and then move to point B. Typing -`[prefix] S' and input `frac' enclose the region like this; - - \frac{a/c} - -Normally, the expression `a/c' is translated to `\frac{a}{c}'. An -enclosing add-in is useful for modifying `/' to `}{'. - -* Menu: - -* Defining option-add-in:: -* Defining argument-add-in:: -* Defining enclosing-add-in:: - - - -File: yatexe, Node: Defining option-add-in, Next: Defining argument-add-in, Prev: How the add-in function works, Up: How the add-in function works - -Defining `option add-in' -........................ - - If you want `{|c|c|c|}' for all `tabular' environment, - - (defun YaTeX:tabular () - "{|c|c|c|}") - -is enough. If you want more complicated format, define as below. - - (defun YaTeX:tabular () - "{@{\\vrule width 1pt\\ }|||@{\\ \\vrule width 1pt}}") - -Note that the character `\' must be described as `\\' in Emacs-Lisp. The -next example reads the tabular format from keyboard. - (defun YaTeX:tabular () - (concat "{" (read-string "Rule: ") "}")) - - - -File: yatexe, Node: Defining argument-add-in, Next: Defining enclosing-add-in, Prev: Defining option-add-in, Up: How the add-in function works - -Defining `argument add-in' -.......................... - - This section describes how to define the add-in function for -`\newcommand'. - - The first argument of `\newcommand' begins always with `\'. The second -argument is usually so complex that we can not edit them in the -minibuffer. Here is the created function considering this. - - (defun YaTeX::newcommand (n) ;n is argument position - (cond - ((= n 1) ;1st argument is macro name - (read-string "Command: " "\\")) ;initial input `\' - ((= n 2) "") ;do nothing when reading arg#2 - (t nil))) - - Note that when the `argument add-in' function return `nil', normal -argument reader will be called. - - - -File: yatexe, Node: Defining enclosing-add-in, Prev: Defining argument-add-in, Up: How the add-in function works - -Defining `enclosing add-in' -........................... - - This section describes how to define the add-in function for text -enclosed by `\frac{}'. - - When enclosing the text `5/3' by `\frac{}', you might want to replace -`/' with `}{'. Enclosing function `YaTeX::frac-region' is called with two -arguments, beginning of enclosed text and end of enclosed text. The -function is expected to replace `/' with `}{'. Here is an example -expression. - - (defun YaTeX::frac-region (beg end) - (catch 'done - (while (search-forward "/" end t) - (goto-char (match-beginning 0)) - (if (y-or-n-p "Replace this slash(/) with `}{'") - (throw 'done (replace-match "}{"))) - (goto-char (match-end 0))))) - - - -File: yatexe, Node: How the function is called, Next: Useful functions for creating add-in, Prev: How the add-in function works, Up: Add-in functions - -How the function is called --------------------------- - - YaTeX calls the add-in functions for specified begin-type, section-type, -and maketitle-type command, if any. `Option add-in' functions for -begin-type are called when `\begin{ENV}' has been inserted, functions for -section-type are called just before input of the first argument, and -functions for maketitle-type is called after maketitle-type command has -been inserted. `Argument add-in' functions are called at each entry of -arguments for section-type commands. - - - -File: yatexe, Node: Useful functions for creating add-in, Next: Contribution, Prev: How the function is called, Up: Add-in functions - -Useful functions for creating add-in ------------------------------------- - - Many add-in functions for typical LaTeX commands are defined in -`yatexadd.el'. Those are also useful as references. Here are the short -descriptions on useful functions, where [F] means function, [A] means -arguments, [D] means description. - -`[F]' - YaTeX:read-position -`[A]' - Character list which can show up in the brackets -`[D]' - Return the location specifier such as `[htb]'. When nothing is - entered, omit [] itself. If the possible characters are "htbp", call - this function as `(YaTeX:read-position "htbp")' - -`[F]' - YaTeX:read-coordinates -`[A]' - Base prompt, X-axis prompt, Y-axis prompt (each optional) -`[D]' - Read the coordinates with the prompt "BasePrompt X-axisPrompt:" for - X-axis, "BasePrompt Y-axisPrompt:" for Y-axis, and return it in the - form of "(X,Y)". The default prompts are `Dimension', `X', `Y' - respectively. - -`[F]' - YaTeX:check-completion-type -`[A]' - One of the symbols: 'begin, 'section, or 'maketitle -`[D]' - Check the current completion type is specified one and cause error - if not. The variable `YaTeX-current-completion-type' holds the symbol - according to the current completion type. - - - -File: yatexe, Node: Contribution, Prev: Useful functions for creating add-in, Up: Add-in functions - -Contribution ------------- - - If you make your own pretty function and you let it be in public, please -send me the function. I'm going to include it in the next release. - - - -File: yatexe, Node: Add-in generator, Prev: Add-in functions, Up: Customizations - -Add-in generator -================ - - First, don't forget to read the section of add-in functions *Note Add-in -functions::. If you easily understand how to define them, there's no need -to read this section. But being not familiar with Emacs-Lisp, when you -don't have clear idea what to do, this section describes how to get YaTeX -make add-in function. - - There are two methods of generation. One is for fully interactive -generator for beginners and another requires little knowledge of -Emacs-Lisp. - - -Generator for beginners ------------------------ - The former generator is called by - `M-x YaTeX-generate' - -strokes. All you have to do is follow the guidances. Defying them may -cases the disaster (I wonder what is it???). So when you make some -mistake, it is recommendable to type `C-g' and start afresh. - - -Simple generator ----------------- - - The latter generator is invoked by the next sequence. `M-x -YaTeX-generate-simple' This generator can make both "option add-in" and -"argument add-in" (*refer the section add-in functions* *Note How the -add-in function works::), whereas `YaTeX-generate' cannot make "argument -addin". - - For example, assume you have the LaTeX command as follows. - - \epsinput[t](250,50){hoge.eps}{plain}{Picture of foo} - (A) (B) (1) (2) (3) - (A)Optional parameter to specify the position - One of t(top), b(bottom), l(left), r(right) - (B)Maximum size of frame - (1)1st argument is filename of EPS file - (2)2nd argument indicates - plain do nothing - frame make frame around image - dframe make double-frame around image - for included EPS file. - (3)Caption for the picture - - Now get start with generation. Typing `M-x YaTeX-generate-simple' -brings the prompt: - (O)ption? (A)rgument? - - -Generating "option add-in" -.......................... - - Since (A), (B) above are optional argument, all we have to do to -complete them is define the option add-in for them. Let's generate the -function to complete (A). - - M-x YaTeX-generate-simple RET - epsinput RET - o - -Typing as above leads the next prompt. - - Read type(1): (S)tring (C)omplete (F)ile ([)option (P)osition co(O)rd. (q)uit - - This asks that "Which type is the completion style of 1st argument?". -Here are the possible completion style. - -`String' - read plain string -`Complete' - read with completion -`File' - read file name -`Option' - read optional string (if string omitted, omit [] too) -`Position' - read positional option (like [htbp]) -`Coord.' - read coordinates -`Quit' - quit from generating - - Since (A) is the optional argument to specify the location of included -EPS file, the completion style is `Position', and the possible characters -are t, b, l, and r. To tell these information to generator, operate as -follows. - - Read type(1).... p - Acceptable characters: tblr RET - - (B) is coordinate. So its completion style is coOrd. We want a prompt -meaning "Maximum size" when completion. - - Read type(2).... o - Prompt for coordinates: Max size RET - - That's all for optional argument. Select quit. - - Read type(3).... q - - Then the generated option add-in function for \epsinput will be shown in -the next window. - - -Generating "argument add-in" -............................ - - Next, create the argument add-in. The arguments for \epsinput are EPS -file name, framing style, and caption string in sequence. - - M-x YaTeX-generate-simple RET - epsinput RET - a - - Above key strokes bring the prompt that asks the number of argument. -Answer it with 3. - - How many arguments?: 3 RET - - Then the generator asks the completion style and prompt for completion. -Answer them. `f' for FileName and prompt string. - - Read type(1).... f - Prompt for argument#1 EPS file name RET - - The second argument is one of selected symbol. So the completion type -is `Completion'. - - Read type(2).... c - Prompt for argument#2 Include style RET - - Then all the candidates ready to be read. Type single RET after -entering all. - - Item[1](RET to exit): plain RET - Item[2](RET to exit): frame RET - Item[3](RET to exit): dframe RET - Item[4](RET to exit): RET - - The following prompt asks whether the entered string must belong to -candidates or not. In this case, since the argument must be one of -`plain', `frame', and `dframe', type `y'. - - Require match? (y or n) y - - The last argument is the caption string for which any completion is -needed. - - Read type(3).... s - Prompt for argument#3 Caption RET - default: Figure of RET - - Finally we'll get the argument add-in in the next window. - - -Contribution ------------- - - If you get your own pretty function and you let it be in public, please -steel yourself in the happy atmosphere and do not send me the function. I -do know it is not fine because it is generated by yatexgen:-p. - - - -File: yatexe, Node: Etcetera, Next: Copying, Prev: Customizations, Up: Top - -Etcetera -******** - - The standard completion tables provided in `yatex.el' contain a few -LaTeX commands I frequently use. This is to lessen the key strokes to -complete entire word, because too many candidates rarely used often cause -too many hits. Therefore always try to use completion in order to enrich -your dictionary, and you will also find `Wild Bird' growing suitable for -your LaTeX style. - - The package name `Wild Bird' is the English translation of Japanese -title `Yachou', which is a trick on words of Japanese. - - - -File: yatexe, Node: Copying, Prev: Etcetera, Up: Top - -Copying -******* - - This program is distributed as a free software. You can -use/copy/modify/redistribute this software freely but with NO warranty to -anything as a result of using this software. Adopting code from this -program is also free. But I would not do contract act. - -Any reports and suggestions are welcome as long as I feel interests in -this software. My possible e-mail address is `yuuji@yatex.org'. (as of -Jan.2004) And there is mailing list for YaTeX. Although the common -language is Japanese, questions in English will be welcome. To join the -ML, send the mail whose subject is `append' to the address -`yatex@yatex.org. If you have some question, please ask to -`yatex-admin@yatex.org'. - - The specification of this software will be surely modified (depending on -my feelings) without notice :-p. - - - HIROSE Yuuji - - -Tag table: -Node: Top146 -Node: What is YaTeX?1487 -Node: Main features1860 -Node: Installation3452 -Node: Typesetting4229 -Node: Calling typesetter5298 -Node: Calling previewer7502 -Node: Printing out7863 -Node: %#notation8155 -Node: Changing typesetter8531 -Node: Splitting input files8895 -Node: Static region for typesetting10319 -Node: Lpr format11448 -Node: Editing %# notation12505 -Node: Completion13024 -Node: Begin-type completion13584 -Node: Section-type completion16627 -Node: view-sectioning19062 -Node: Large-type completion20642 -Node: Maketitle-type completion21373 -Node: Arbitrary completion21925 -Node: End completion22315 -Node: Accent completion22785 -Node: Image completion23402 -Node: Greek letters completion25659 -Node: Local dictionaries26386 -Node: Commenting out27323 -Node: Cursor jump28782 -Node: Jump to corresponding object29094 -Node: Invoking image processor30495 -Node: Jump to main file31838 -Node: Jumping around the environment32203 -Node: Jumping to last completion position32621 -Node: Changing and Deleting33130 -Node: Changing LaTeX commands33522 -Node: Killing LaTeX commands34699 -Node: Filling35884 -Node: Updation of includeonly37735 -Node: What column38532 -Node: Intelligent newline39617 -Node: Usepackage checker41271 -Node: Online help41862 -Node: Browsing file hierarchy43537 -Node: Cooperation with other packages45274 -Node: Customizations45979 -Node: Lisp variables46313 -Node: All customizable variables47317 -Node: Sample definitions57116 -Node: Hook variables57629 -Node: Hook file58333 -Node: Add-in functions58672 -Node: How the add-in function works59532 -Node: Defining option-add-in61731 -Node: Defining argument-add-in62453 -Node: Defining enclosing-add-in63335 -Node: How the function is called64189 -Node: Useful functions for creating add-in64865 -Node: Contribution66270 -Node: Add-in generator66544 -Node: Etcetera71916 -Node: Copying72521 - -End tag table +Info file: yatexe, -*-Text-*- +produced by `texinfo-format-buffer' +from file `yatexe.tex' +using `texinfmt.el' version 2.38 of 3 July 1998. + + + + + + +File: yatexe, Node: Top, Next: What is YaTeX?, Prev: (dir), Up: (dir) + +* Menu: + +* What is YaTeX?:: +* Main features:: What YaTeX can do +* Installation:: Guide to install +* Typesetting:: Call typesetting processes +* %#notation:: Meta-keyword `%#' +* Completion:: Input LaTeX commands with completion +* Local dictionaries:: Directory dependent completion +* Commenting out:: Commenting/uncommenting text +* Cursor jump:: Jumping to related position +* Changing and Deleting:: Changing/deleting certain unit of text +* Filling:: Filling an item or paragraph +* Updation of includeonly:: Free from maintaining includeonly +* What column:: Check what table-column the cursor belong +* Intelligent newline:: Guess requisites of new line +* Usepackage checker:: Selecting correct \usepackage is YaTeX's job +* Online help:: On-line documentation of LaTeX +* Browsing file hierarchy:: Walking through file hierarchy +* Cooperation with other packages:: Work well with gmhist, min-out +* Customizations:: How to breed `Wild Bird' +* Etcetera:: YaTeX is acquisitive. +* Copying:: Redistribution + + + + +File: yatexe, Node: What is YaTeX?, Next: Main features, Prev: Top, Up: Top + +What is YaTeX? +************** + + YaTeX automates typesetting and previewing of LaTeX and enables +completing input of LaTeX mark-up command such as `\begin{}'..`\end{}'. + + YaTeX also supports Demacs which runs on MS-DOS(386), Mule (Multi +Language Enhancement to GNU Emacs), and latex on DOS. + + + +File: yatexe, Node: Main features, Next: Installation, Prev: What is YaTeX?, Up: Top + +Main features +************* + + * Invocation of typesetter, previewer and related programs(`C-c t') + * Typesetting on static region which is independent from point + * Semiautomatic replacing of `\includeonly' + * Jumping to error line(`C-c '') + * Completing-read of LaTeX commands such as `\begin{}', `\section' etc. + (`C-c b', `C-c s', `C-c l', `C-c m') + * Enclosing text into LaTeX environments or commands (`C-u' + ABOVEKEYSTROKES) + * Displaying the structure of text at entering sectioning commands + * Lump shifting of sectioning commands (*Note view-sectioning::) + * Learning unknown/new LaTeX commands for the next completion + * Argument reading with a guide for complicated LaTeX commands + * Generating argument-readers for new/unsupported commands(`yatexgen') + * Quick changing or deleting of LaTeX commands(`C-c c', `C-c k') + * Jumping from and to inter-file, begin<->end, ref<->label(`C-c g') + * Blanket commenting out or uncommenting (`C-c >', `C-c <', `C-c ,', + `C-c .') + * Easy input of accent mark, math-mode's commands and Greek letters + (`C-c a', `;', `:') + * Online help for the popular LaTeX commands (`C-c ?', `C-c /') + * Document files hierarchy browser (`C-c d') + * Adding automatically \usepackage corresponding to inputting LaTeX + macro with completion + * Allow you to forget creating \label{}s, \ref{} or \cite{} completion + automatically generate labels. + + + +File: yatexe, Node: Installation, Next: Typesetting, Prev: Main features, Up: Top + +Installation +************ + + Put next two expressions into your `~/.emacs'. + + (setq auto-mode-alist + (cons (cons "\\.tex$" 'yatex-mode) auto-mode-alist)) + (autoload 'yatex-mode "yatex" "Yet Another LaTeX mode" t) + +Next, add certain path name where you put files of YaTeX to your +load-path. If you want to put them in `~/src/emacs', write + + (setq load-path + (cons (expand-file-name "~/src/emacs") load-path)) + +in your `~/.emacs' + + Then, yatex-mode will be automatically loaded when you visit a file +which has extension `.tex'. If yatex-mode is successfully loaded, mode +string on mode line will be turned to "YaTeX". + + + + +File: yatexe, Node: Typesetting, Next: %#notation, Prev: Installation, Up: Top + +Typesetting +*********** + + The prefix key stroke of yatex-mode is `C-c' (Press 'C' with Control +key) by default. If you don't intend to change the prefix key stroke, +assume all `[prefix]' as `C-c' in this document. These key strokes +execute typeset or preview command. + +`[prefix] t j' + ... invoke latex +`[prefix] t r' + ... invoke latex on region +`[prefix] t e' + ... invoke latex on current environment or whole portion of + current formulas in math-mode. +`[prefix] t d' + ... invoke dvipdfmx after successful typesetting +`[prefix] t k' + ... kill current typesetting process +`[prefix] t b' + ... invoke bibtex +`[prefix] t i' + ... invoke makeindex +`[prefix] t d' + ... invoke latex && dvipdfmx +`[prefix] t p' + ... preview +`[prefix] t l' + ... lpr dvi-file +`[prefix] t s' + ... search current string on xdvi-remote + +* Menu: + +* Calling typesetter:: +* Calling previewer:: +* Printing out:: + + + +File: yatexe, Node: Calling typesetter, Next: Calling previewer, Prev: Typesetting, Up: Typesetting + +Calling typesetter +================== + + Typing `[prefix] t j', the current editing window will be divided +horizontally when you invoke latex command, and log message of LaTeX +typesetting will be displayed in the other window; called typesetting +buffer. The typesetting buffer automatically scrolls up and traces LaTeX +warnings and error messages. If you see latex stopping by an error, you +can send string to latex in the typesetting buffer. + + If an error stops the LaTeX typesetting, this key stroke will move the +cursor to the line where LaTeX error is detected. + +`[prefix] '' +`([prefix]+single quotation)' + + ... jump to the previous error or warning + + If you find a noticeable error, move to the typesetting buffer and move +the cursor on the line of error message and type `SPACE' key. This makes +the cursor move to corresponding source line. + + YaTeX-typeset-region invoked by `[prefix] tr' call typesetter for +region. The region is specified by standard point and mark, or by +`%#BEGIN' and `%#END' marks. Selected region will be copied to the +temporary file `texput.tex' with the same preamble as the main file of +current editing sources. Be sure to put all local macro settings in +preamble, not after `\begin{document}'. The method of specification of +the region is shown in the section *Note %#notation::. + + The documentclass for typeset-region is the same as that of editing file +if you edit one file, and is the same as main file's if you edit splitting +files. + + The `[prefix] te' key automatically marks current inner environment or +inner math mode and then call typeset-region with marked region. This is +convenient to quick view of current tabular environment or current editing +formulas. Keeping previewer window for `texput.dvi' is handy for +debugging. Since `[prefix] te' selects the inner-most environment as +region, it is not suitable for partial typesetting of doubly or more +composed environment. If you want to do partial typesetting for a nested +environment, use `[prefix] tr' for static-region, which is described in +the section *Note %#notation::. + + + +File: yatexe, Node: Calling previewer, Next: Printing out, Prev: Calling typesetter, Up: Typesetting + +Calling previewer +================= + + `[prefix] t p' invokes the TeX previewer. And if you are using +xdvi-remote, which can be controled from other terminals, `[prefix] t s' +enables you to search current string at the cursor on the running xdvi +window. + + + +File: yatexe, Node: Printing out, Prev: Calling previewer, Up: Typesetting + +Printing out +============ + + When you type `[preifx] t l', YaTeX asks you the range of dvi-printing +by default. You can skip this by invoking it with universal-argument as +follows: + + C-u [prefix] tl + + + +File: yatexe, Node: %#notation, Next: Completion, Prev: Typesetting, Up: Top + +%# notation +*********** + + You can control the typesetting process by describing `%#' notations in +the source text. + +* Menu: + +* Changing typesetter:: +* Splitting input files:: +* Static region for typesetting:: +* Lpr format:: +* Controlling which command to invoke:: +* Editing %# notation:: + + + +File: yatexe, Node: Changing typesetter, Next: Splitting input files, Prev: %#notation, Up: %#notation + +To change the `latex' command or to split a source text. +======================================================== + + To change the typesetting command, write + + %#!latex-big + +anywhere in the source text. This is useful for changing typesetter. + + + +File: yatexe, Node: Splitting input files, Next: Static region for typesetting, Prev: Changing typesetter, Up: %#notation + +Splitting input files +===================== + + And if you split the source text and edit subfile that should be +included from main text. + + %#!latex main.tex + +will be helpful to execute latex on main file from sub text buffer. Since +this command line after `%#!' will be sent to shell literally, next +description makes it convenient to use ghostview as dvi-previewer. + + %#!latex main && dvi2ps main.dvi > main + +Note that YaTeX assumes the component before the last period of the last +word in this line as base name of the main LaTeX source. The `%f' +notation in this line is replaced by main file name, and `%r' replaced by +root name of main file name. If you specify `%f' or `%r', YaTeX always +ask you the name of main file at the first typesetting. + + To make best use of the feature of inter-file jumping by `[prefix] g' +(see *Note Cursor jump::), take described below into consideration. + + * You can put split texts in sub directory, but not in sub directory of + sub directory. + * In the main text, specify the child file name with relative path name + such as \include{chap1/sub}, when you include the file in a + sub-directory. + * In a sub-text, write `%#!latex main.tex' even if `main.tex' is in the + parent directory(not %#!latex ../main.tex). + + + +File: yatexe, Node: Static region for typesetting, Next: Lpr format, Prev: Splitting input files, Up: %#notation + +Static region +============= + + Typeset-region by `[prefix] tr' passes the region between point and mark +to typesetting command by default. But when you want to typeset static +region, enclose the region by `%#BEGIN' and `%#END' as follows. + + %#BEGIN + TheRegionYouWantToTypesetManyTimes + %#END + +This is the rule of deciding the region. + + 1. If there exists %#BEGIN before point, + + 1. If there exists %#END after %#BEGIN, + * From %#BEGIN to %#END. + + 2. If %#END does not exist after %#BEGIN, + * From %#BEGIN to the end of buffer. + + 2. If there does not exist %#BEGIN before point, + * Between point and mark(standard method of Emacs). + + It is useful to write `%#BEGIN' in the previous line of \begin and +`%#END' in the next line of \`end' when you try complex environment such +as `tabular' many times. It is also useful to put only `%#BEGIN' alone at +the middle of very long text. Do not forget to erase `%#BEGIN' `%#END' +pair. + + + +File: yatexe, Node: Lpr format, Next: Controlling which command to invoke, Prev: Static region for typesetting, Up: %#notation + +Lpr format +========== + + Lpr format is specified by three Lisp variables. Here are the default +values of them. + +`(1)dviprint-command-format' + `"dvi2ps %f %t %s | lpr"' +`(2)dviprint-from-format' + `"-f %b"' +`(3)dviprint-to-format' + `"-t %e"' + + On YaTeX-lpr, `%s' in (1) is replaced by the file name of main text, +`%f' by contents of (2), %t by contents of (3). At these replacements, +`%b' in (2) is also replaced by the number of beginning page, `%e' in (3) +is replaced by the number of ending page. But `%f' and `%t' are ignored +when you omit the range of print-out by `C-u [prefix] tl'. + + If you want to change this lpr format temporarily, put a command such as +follows somewhere in the text: + + %#LPR dvi2ps %f %t %s | 4up -page 4 | texfix | lpr -Plp2 + + And if you want YaTeX not to ask you the range of printing out, the next +example may be helpful. + + %#LPR dvi2ps %s | lpr + + + +File: yatexe, Node: Controlling which command to invoke, Next: Editing %# notation, Prev: Lpr format, Up: %#notation + +Controlling which command to invoke +=================================== + +These %# notation below can control which command to invoke for LaTeX +related process. + + `%#BIBTEX' + + ... Command line for makeindex ([prefix] t i) + `%#MAKEINDEX' + + ... Command line for bibtex ([prefix] t b) + +If you want to invoke "makeidx hogehoge" to update index, put the next +line some upper place in the source, for example. + + %#MAKEINDEX makeidx hogehoge + + + + +File: yatexe, Node: Editing %# notation, Prev: Controlling which command to invoke, Up: %#notation + +Editing %# notation +=================== + + To edit `%#' notation described above, type + +`[prefix] %' + ... editing %# notation menu + +and select one of the entry of the menu as follows. + + !)Edit-%#! B)EGIN-END-region L)Edit-%#LPR + +Type `!' to edit `%#!' entry, `b' to enclose the region with `%#BEGIN' and +`%#END', and `l' to edit `%#LPR' entry. When you type `b', all `%#BEGIN' +and `%#END' are automatically erased. + + + +File: yatexe, Node: Completion, Next: Local dictionaries, Prev: %#notation, Up: Top + +Completion +********** + + YaTeX makes it easy to input the LaTeX commands. There are several +kinds of completion type, begin-type, section-type, large-type, etc... + +* Menu: + +* Begin-type completion:: +* Section-type completion:: +* Large-type completion:: +* Maketitle-type completion:: +* Arbitrary completion:: +* End completion:: +* Accent completion:: +* Image completion:: +* Greek letters completion:: + + + +File: yatexe, Node: Begin-type completion, Next: Section-type completion, Prev: Completion, Up: Completion + +Begin-type completion +===================== + + "Begin-type completion" completes commands of `\begin{env}' ... +`\end{env}'. All of the begin-type completions begin with this key +sequence. + +`[prefix] b' + ... start begin-type completion + +An additional key stroke immediately completes a frequently used LaTeX +`\begin{}'...`\`end'{}' environment. + +`[prefix] b c' + ... `\begin{center}...\end{center}' +`[prefix] b d' + ... `\begin{document}...\end{document}' +`[prefix] b D' + ... `\begin{description}...\end{description}' +`[prefix] b e' + ... `\begin{enumerate}...\end{enumerate}' +`[prefix] b E' + ... `\begin{equation}...\end{equation}' +`[prefix] b i' + ... `\begin{itemize}...\end{itemize}' +`[prefix] b l' + ... `\begin{flushleft}...\end{flushleft}' +`[prefix] b m' + ... `\begin{minipage}...\end{minipage}' +`[prefix] b t' + ... `\begin{tabbing}...\end{tabbing}' +`[prefix] b T' + ... `\begin{tabular}...\end{tabular}' +`[prefix] b^T' + ... `\begin{table}...\end{table}' +`[prefix] b p' + ... `\begin{picture}...\end{picture}' +`[prefix] b q' + ... `\begin{quote}...\end{quote}' +`[prefix] b Q' + ... `\begin{quotation}...\end{quotation}' +`[prefix] b r' + ... `\begin{flushright}...\end{flushright}' +`[prefix] b v' + ... `\begin{verbatim}...\end{verbatim}' +`[prefix] b V' + ... `\begin{verse}...\end{verse}' + + Any other LaTeX environments are made by completing-read of the Emacs +function. + +`[prefix] b SPACE' + ... begin-type completion + +The next message will show up in the minibuffer + + Begin environment(default document): + +by typing `[prefix] b'. Put the wishing environment with completion in +the minibuffer, and `\begin{env}'...\`\end{env}' will be inserted in the +LaTeX source text. If the environment you want to put does not exist in +the YaTeX completion table, it will be registered in the user completion +table. YaTeX automatically saves the user completion table in the user +dictionary file at exiting of emacs. + +At the completion of certain environments, the expected initial entry will +automatically inserted such as `\item' for `itemize' environment. If you +don't want the entry, it can be removed by undoing. + + If you want to enclose some paragraphs which have already been written, +invoke the begin-type completion with changing the case of `b' of key +sequence upper(or invoke it with universal argument by `C-u' prefix). + + The following example encloses a region with `description' environment. + +`[prefix] B D' +`(or ESC 1 [prefix] b D)' +`(or C-u [prefix] b D)' + + ... begin-type completion for region + + This enclosing holds good for the completing input by `[prefix] b SPC'. +`[prefix] B SPC' enclose a region with the environment selected by +completing-read. + + + +File: yatexe, Node: Section-type completion, Next: Large-type completion, Prev: Begin-type completion, Up: Completion + +Section-type completion +======================= + + "Section-type completion" completes section-type commands which take an +argument or more such as `\section{foo}'. To invoke section-type +completion, type + +`[prefix] s' + ... section-type completion + +then the prompt + + (C-v for view) \???{} (default documentclass): + +will show up in the minibuffer. Section-type LaTeX commands are completed +by space key, and the default value is selected when you type nothing in +the minibuffer. + + Next, + + \section{???}: + +prompts you the argument of section-type LaTeX command. For example, the +following inputs + + \???{} (default documentclass): section + \section{???}: Hello world. + +will insert the string + + \section{Hello world.} + +in your LaTeX source. When you neglect argument such as + + (C-v for view) \???{} (default section): vspace* + \vspace*{???}: + +YaTeX puts + + \vspace*{} + +and move the cursor in the braces. + + In LaTeX command, there are commands which take more than one arguments +such as `\addtolength{\topmargin}{8mm}'. To complete these commands, +invoke section-type completion with universal argument as, + + C-u 2 [prefix] s (or ESC 2 [prefix] s) + +and make answers in minibuffer like this. + + (C-v for view) \???{} (default vspace*): addtolength + \addtolength{???}: \topmargin + Argument 2: 8mm + +`\addtolength' and the first argument `\topmargin' can be typed easily by +completing read. Since YaTeX also learns the number of arguments of +section-type command and will ask that many arguments in future +completion, you had better tell the number of arguments to YaTeX at the +first completion of the new word. But you can change the number of +arguments by calling the completion with different universal argument +again. + + + Invoking section-type completion with `[Prefix] S' (Capital `S') +includes the region as the first argument of section-type command. + + The section/large/maketitle type completion can work at the prompt for +the argument of other section-type completion. Nested LaTeX commands are +efficiently read with the recursive completion by typing YaTeX's +completion key sequence in the minibuffer. + +* Menu: + +* view-sectioning:: + + + +File: yatexe, Node: view-sectioning, Prev: Section-type completion, Up: Section-type completion + +view-sectioning +--------------- + + In the minibuffer at the prompt of section-type command completion, +typing `C-v' shows a list of sectioning commands in source text(The line +with `<<--' mark is the nearest sectioning command). Then, default +sectioning command appears in the minibuffer. You can go up/down +sectioning command by typing `C-p'/`C-n', can scrolls up/down the listing +buffer by `C-v'/`M-v', and can hide sectioning commands under certain +level by 0 through 6. Type `?' in the minibuffer of sectioning prompt +for more information. + + You can generate this listing buffer (`*Sectioning Lines*' buffer) by +typing +`M-x YaTeX-section-overview' + ... Generate *Sectioning Lines* buffer + +from the LaTeX source buffer. In this listing buffer, typing `u' on the +sectioning command shifts up the corresponding sectioning command in +source text and `d' shifts down. After marking lines in the listing +buffer, typing `U' shifts up all sectioning commands in the region, and +`U' shifts down. Here are all the key bindings of `*Sectioning Lines*' +buffer. + +`SPC' + ... Jump to corresponding source line +`.' + ... Display corresponding source line +`u' + ... Shift up a sectioning line +`d' + ... Shift down a sectioning line +`U' + ... Shift up sectioning lines in region +`D' + ... Shift down sectioning lines in region +`0...6' + ... Hide sectioning commands whose level is lower than n + + + + +File: yatexe, Node: Large-type completion, Next: Maketitle-type completion, Prev: Section-type completion, Up: Completion + +Large-type completion +===================== + + "Large-type completion" inputs the font or size changing descriptions +such as `{\large }'. When you type + +`[prefix] l' + ... large-type completion + +the message in the minibuffer + + {\??? } (default large): + +prompts prompts you large-type command with completing-read. There are +TeX commands to change fonts or sizes, `it', `huge' and so on, in the +completion table. + + Region-based completion is also invoked by changing the letter after +prefix key stroke as `[prefix] L'. It encloses the region by braces with +large-type command. + + + +File: yatexe, Node: Maketitle-type completion, Next: Arbitrary completion, Prev: Large-type completion, Up: Completion + +Maketitle-type completion +========================= + + We call it "maketitle-type completion" which completes commands such as +`\maketitle'. Take notice that maketitle-type commands take no arguments. +Then, typing + +`[prefix] m' + ... maketitle-type completion + +begins maketitle-completion. Above mentioned method is true for +maketitle-completion, and there are LaTeX commands with no arguments in +completion table. + + + +File: yatexe, Node: Arbitrary completion, Next: End completion, Prev: Maketitle-type completion, Up: Completion + +Arbitrary completion +==================== + + You can complete certain LaTeX command anywhere without typical +completing method as described, by typing + +`[prefix] SPC' + ... arbitrary completion + +after the initial string of LaTeX command that is preceded by `\'. + + + +File: yatexe, Node: End completion, Next: Accent completion, Prev: Arbitrary completion, Up: Completion + +End completion +============== + + YaTeX automatically detects the opened environment and close it with +\`\end{environment}'. Though proficient YaTeX users never fail to make +environment with begin-type completion, some may begin an environment +manually. In that case, type + +`[prefix] e' + ... `end' completion + +at the end of the opened environment. + + + +File: yatexe, Node: Accent completion, Next: Image completion, Prev: End completion, Up: Completion + +Accent completion +================= + + When you want to write the European accent marks(like `\`{o}'), + +`[prefix] a' + ... accent completion + +shows the menu + + 1:` 2:' 3:^ 4:" 5:~ 6:= 7:. u v H t c d b + +in the minibuffer. Chose one character or corresponding numeric, and you +will see + + \`{} + +in the editing buffer with the cursor positioned in braces. Type one more +character `o' for example, then + + \`{o} + +will be completed, and the cursor gets out from braces. + + + +File: yatexe, Node: Image completion, Next: Greek letters completion, Prev: Accent completion, Up: Completion + +Image completion of mathematical sign +===================================== + + Arrow marks, sigma mark and those signs mainly used in the TeX's math +environment are completed by key sequences which imitate the corresponding +symbols graphically. This completion only works in the math environment. +YaTeX automatically detects whether the cursor located in math environment +or not, and change the behavior of key strokes `;' and `:'. + + By the way, we often express the leftarrow mark by `<-' for example. +Considering such image, you can write `\leftarrow' by typing `<-' after +`;' (semicolon) as a prefix. In the same way, `\longleftarrow' (`<--') is +completed by typing `;<--', infinity mark which is imitated by `oo' is +completed by typing `;oo'. + + Here are the sample operations in YaTeX math-mode. + + INPUT Completed LaTeX commands + ; < - `\leftarrow' + ; < - - `\longleftarrow' + ; < - - > `\longleftrightarrow' + ; o `\circ' + ; o o `\infty' + + In any case, you can quit from image completion and can move to the next +editing operation if the LaTeX command you want is shown in the buffer. + + `;' itself in math-environment is inserted by `;;'. Typing `TAB' in the +midst of image completion shows all of the LaTeX commands that start with +the same name as string you previously typed in. In this menu buffer, +press `RET' after moving the cursor (by `n', `p', `b', `f') to insert the +LaTeX command. + + To know all of the completion table, type `TAB' just after `;'. And +here is the sample menu by `TAB' after `;<'. + + KEY LaTeX sequence sign + < \leq < + ~ + << \ll << + <- \leftarrow <- + <= \Leftarrow <= + + You can define your favorite key-vs-sequence completion table in the +Emacs-Lisp variable `YaTeX-math-sign-alist-private'. See also +`yatexmth.el' for the information of the structure of this variable. + + + +File: yatexe, Node: Greek letters completion, Prev: Image completion, Up: Completion + +Greek letters completion +======================== + + Math-mode of YaTeX provides another image completion, Greek letters +completion in the same method. After prefix `:', typing `a' makes +`\alpha', `b' makes `\beta' and `g' makes `\gamma' and so on. First, type +`:TAB' to know all the correspondence of alphabets vs. Greek letters. + + If you will find `;' or `:' doesn't work in correct position of math +environment, it may be a bug of YaTeX. Please send me a bug report with +the configuration of your text, and avoid it temporarily by typing `;' or +`:' after universal-argument(`C-u') which forces `;' and `:' to work as +math-prefix. + + + +File: yatexe, Node: Local dictionaries, Next: Commenting out, Prev: Completion, Up: Top + +Local dictionaries +****************** + + Tables for completion consist of three dictionaries; `standard +dictionary' built in `yatex.el', `user dictionary' for your common private +commands, and `local dictionary' that is effective in a certain directory. + + When you input the command unknown to YaTeX at a completion in the +minibuffer, YaTeX asks you with the following prompt; + + `foo' is not in table. Register into: U)serDic L)ocalDic N)one D)iscard + +In this menu, typing `u' updates your `user dictionary', `l' updates your +local dictionary, `n' updates only on-memory dictionary which go through +only current Emacs session, and `d' updates no dictionary and throws the +new word away. + + If you find this switching feature meaningless and bothersome, put the +next expression into your `~/.emacs' + + (setq YaTeX-nervous nil) + + + +File: yatexe, Node: Commenting out, Next: Cursor jump, Prev: Local dictionaries, Up: Top + +Commenting out +************** + + You may want to comment out some region. + +`[prefix] >' + ... comment out region by % +`[prefix] <' + ... uncomment region + +cause an operation to the region between point and mark. + +`[prefix] .' + ... comment out current paragraph +`[prefix] ,' + ... uncomment current paragraph + +comments or uncomments the paragraph where the cursor belongs. This +`paragraph' means the region marked by the function mark-paragraph, bound +to `ESC h' by default. It is NOT predictable what will happen when you +continuously comment out some paragraph many times. + + You can also comment out an environment between `\begin' and `\end', or +a `\begin'-\`\end' pair themselves, by making the following key strokes on +the line where `\begin{}' or `\end{}' exists. + +`[prefix] >' + ... comment out from \begin to \`end' +`[prefix] <' + ... uncomment from \begin to \`end' + +comment whole the contents of environment. Moreover, + +`[prefix] .' + ... comment out \begin and \`end' +`[prefix] ,' + ... uncomment \begin and \`end' + +(un)comments out only environment declaration: `\begin{}' and `\end{}'. +NOTE that even if you intend to comment out some region, invoking +`[prefix] >' on the `\begin',`\end' line decides to work in `commenting +out from `\begin' to `\end'' mode. + + + + +File: yatexe, Node: Cursor jump, Next: Changing and Deleting, Prev: Commenting out, Up: Top + +Cursor jump +*********** + + +* Menu: + +* Jump to corresponding object:: +* Invoking image processor:: +* Jump to main file:: +* Jumping around the environment:: +* Jumping to last completion position:: + + + +File: yatexe, Node: Jump to corresponding object, Next: Invoking image processor, Prev: Cursor jump, Up: Cursor jump + +Jump to corresponding object +============================ + + Typing + +`[prefix] g' + ... go to corresponding object + +in a certain place move the cursor to the place corresponding to the LaTeX +command of last place. YaTeX recognize the followings as pairs that have +relation each other. + + * `\begin{}' <-> `\end{}' + * `%#BEGIN' <-> `%#END' + * On the image-including line -> corresponding viewer or drawing tool + * `\label{}' <-> `\ref{}' + * `\include(\input)' -> included file + * `\bibitem{}' <-> `\cite{}' + + On a `\begin',`\end' line, typing `[prefix] g' moves the cursor to the +corresponding `\end',`\begin' line, if its partner really exists. The +behavior on the line `%#BEGIN' and `%#END' are the same. Note that if the +correspondent of `label/ref' or `cite/bibitem' exists in another file, +that file have to be opened to make a round trip between references by +`[prefix] g'. + + If you type `[prefix] g' on the line of `\include{chap1}', typically in +the main text, YaTeX switches buffer to `chap1.tex'. + +`[prefix] 4 g' + ... go to corresponding object in other window + +do the same job as `[prefix] g' except it's done in other window. Note +that this function doesn't work on `begin/end', `%#BEGIN/%#END' pairs +because it is meaningless. + + + +File: yatexe, Node: Invoking image processor, Next: Jump to main file, Prev: Jump to corresponding object, Up: Cursor jump + +Invoking image processor +======================== + + +`image-including line' described above means such lines as +`\epsfile{file=foo.ps}'. If you type `[prefix] g' on that line, YaTeX +automatically searches source of `foo.ps' and invokes image viewer or +drawing tool correspoinding to it. For example; if you draw an image +foo.obj with Tgif and enclose its product named foo.eps by `\epsfile' +command. Typing `[prefix] g' on `\epsfile' line make YaTeX invoke `tgif +foo.obj'. How a processor is choosen is as follows. + + 1. If there is an expression matching with one of the pattern defined in + `YaTeX-processed-file-regexp-alist', extract file name from regexp + group surrounded by \\(\\). (Which group corresponds is written in + the cdr part of each list.) If no matches were found, do nothing. + 2. If there is a pattern as `%PROCESSOR' which is defined in the + variable `YaTeX-file-processor-alist', call that processor giving the + file name with corresponding extension. + 3. If not, check the existence of each file which is supplied the + extension in the cdr part of each list of + `YaTeX-file-processor-alist'. If any, call the corresponding image + viewer or drawing tool. + + + +File: yatexe, Node: Jump to main file, Next: Jumping around the environment, Prev: Invoking image processor, Up: Cursor jump + +Jump to main file +================= + + Typing + +`[prefix] ^' + ... visit main file +`[prefix] 4^' + ... visit main file in other buffer + +in a sub text switch the buffer to the main text specified by `%#!' +notation. + + + +File: yatexe, Node: Jumping around the environment, Next: Jumping to last completion position, Prev: Jump to main file, Up: Cursor jump + +Jumping around the environment +============================== + + And these are the functions which work on the current LaTeX environment: + +`M-C-a' + ... beginning of environment +`M-C-e' + ... `end' of environment +`M-C-@' + ... mark environment + + + +File: yatexe, Node: Jumping to last completion position, Prev: Jumping around the environment, Up: Cursor jump + +Jumping to last completion position +=================================== + +YaTeX always memorize the position of completion into register `3'. So +every time you make a trip to any other part of text other than you are +writing, you can return to the editing paragraph by calling +register-to-point with argument YaTeX-current-position-register, which is +achieved by typing `C-x j 3'(by default). + + + +File: yatexe, Node: Changing and Deleting, Next: Filling, Prev: Cursor jump, Up: Top + +Changing and Deleting +********************* + + These functions are for change or deletion of LaTeX commands already +entered. + +`[prefix] c' + ... change LaTeX command +`[prefix] k' + ... kill LaTeX command + +* Menu: + +* Changing LaTeX commands:: +* Killing LaTeX commands:: + + + +File: yatexe, Node: Changing LaTeX commands, Next: Killing LaTeX commands, Prev: Changing and Deleting, Up: Changing and Deleting + +Changing LaTeX commands +======================= + +`[prefix] c' can change the various (La)TeX commands. This can change the +followings. + * Environment names + * Section-type commands + * Argument of section-type commands + * Optional parameters (enclosed by []) of section-type commands + * Font/size designators + * Math-mode's maketitle-type commands that can be inputted with image + completion + + Typing `[prefix] c' on one of above objects you want to change brings a +suitable reading function sometimes with completion. Note: If you want to +change the argument of section-type command that contains other LaTeX +commands, type `[prefix] c' either of surrounding braces of the argument +in order to make YaTeX ignore the internal LaTeX sequences as an object of +changing. Anyway, it is very difficult to know which argument position +the cursor belongs because the LaTeX commands can be nested and braces can +freely emerge. So keep it mind to put the cursor on a brace when you are +thinking of changing a complicated argument. + + + +File: yatexe, Node: Killing LaTeX commands, Prev: Changing LaTeX commands, Up: Changing and Deleting + +Killing LaTeX commands +====================== + + `[prefix] k' kills the LaTeX commands sometimes with their arguments. +Following table illustrates the correspondence of the invoking position +and what is killed. + + [Invoking position] [action] + \begin, \end line kill \begin,\end pairs + %#BEGIN, %#END line kill %#BEGIN,%#END pairs + on a Section-type command kill section-type command + on a parenthesis kill parentheses + +Note that when killing `\begin, \end' or `%#BEGIN, %#END' pair, the lines +`\begin, \end' or `%#BEGIN, %#END' exist will be killed entirely. So take +care not to create any line that contains more than one `\begin' or so. + +While all operations above are to kill `containers' which surround some +text, universal argument (`C-u') for these commands kills not only +`containers' but also `contents' of them. See below as a sample. + + Original text: [prefix] k C-u [prefix] k + Main \footnote{note} here. Main note here. Main here. + ~(cursor) + + + +File: yatexe, Node: Filling, Next: Updation of includeonly, Prev: Changing and Deleting, Up: Top + +Filling +******* + + +Filling an item +=============== + + To fill a term (descriptive sentences) of `\item', type + +`M-q' + ... fill item + +on that item. + + YaTeX uses the value of the variable `YaTeX-item-regexp' as the regular +expression to search item header in itemize environment. If you make a +newcommand to itemize terms(e.g. `\underlineitem'), put + + (setq YaTeX-item-regexp + "\\(\\\\\\(sub\\)*item\\)\\|\\(\\\\underlineitem\\)") + +in your `~/.emacs'. If you are not familiar with regular expression for +Emacs-Lisp, name a newcommand for `itemize' beginning with `\item' such as +`\itembf', not `\bfitem'. + + This function reformats the `\item' into `hang-indented' style. For +example: + + itemize, enumerate environment: + > + >\item[foo] `foo' is the typical word for describing an + > arbitrarily written.... + description environment: + > \item[bar] When the word `for' is used as an arbitrarily + > word, `bar' is bound to follow it. + + Note that the indent depth of an `\item' word and its descriptive +paragraph are the same in latter case. If you want to use different +depth, invoke fill-paragraph at the beginning of non-whitespace +character(see below). + + +Filling paragraph +================= + + Fill-paragraph is little bit adapted for LaTeX sources. It retains from +filling in certain environments where formatting leads to a disaster such +as verbatim, tabular, or so. And it protects `\verb' expressions from +being folded (The variable `YaTeX-verb-regexp' controls this). Besides, +putting cursor on the first occurrence of non-whitespace character on a +line changes the fill-prefix temporarily to the depth of the line. + + + +File: yatexe, Node: Updation of includeonly, Next: What column, Prev: Filling, Up: Top + +Updation of `\includeonly' +************************** + + When you edit splitting source texts, the notation + + \includeonly{CurrentEditingFileName} + +in the main file reduces the time of typesetting. If you want to hack +other file a little however, you have to rewrite it to + + \includeonly{OtherFileNameYouWantToFix} + +in the main file. YaTeX automatically detects that the current edited +text is not in includeonly list and prompts you + + A)dd R)eplace %)comment? + +in the minibuffer. Type `a' if you want to add the current file name to +`\includeonly' list, `r' to replace \`includeonly' list with the current +file, and type `%' to comment out the `\includeonly' line. + + + +File: yatexe, Node: What column, Next: Intelligent newline, Prev: Updation of includeonly, Up: Top + +What column? +************ + + We are often get tired of finding the corresponding column in large +tabulars. For example, + + \begin{tabular}{|c|c|c|c|c|c|c|c|}\hline + Name&Position&Post No.&Addr.&Phone No.&FAX No.& + Home Addr.&Home Phone\\ \hline + Thunder Bird & 6 & 223 & LA & xxx-yyy & + zzz-www & Japan & 9876-54321 \\ + & 2 & \multicolumn{2}{c|}{Unknown} + &&&(???) + \\ \hline + \end{tabular} + +Suppose you have the cursor located at `(???)' mark, can you tell which +column it is belonging at once? Maybe no. In such case, type + +`[prefix] &' + ... What column + +in that position. YaTeX tells you the column header of the current field. +Since YaTeX assumes the first line of tabular environment as a row of +column headers, you can create a row of virtual column headers by putting +them in the first line and commenting that line with `%'. + + + +File: yatexe, Node: Intelligent newline, Next: Usepackage checker, Prev: What column, Up: Top + +Intelligent newline +******************* + + At the end of begin-type completion of tabular[*], array, itemize, +enumerate or tabbing environment, or typing + +`ESC RET' + ... Intelligent newline + +in these environments inserts the contents corresponding to the current +environment in the next line. (At the begin-type completion, this +contents can be removed by `undo'.) In `tabular' environment, for +example, `ESC RET' inserts the certain number of `&' and trailing `\\', +and `\hline' if other `\hline' is found in backward. Here are the list of +contents vs. environments. + + * `tabular', `tabular*', `array' + + Corresponding number of `&' and `\\'. And `\hline' if + needed. + + * `tabbing' + + The same number of `\>' as `\=' in the first line. + + * `itemize', `enumerate', `description', `list' + + `\item' or `item[]'. + + Note that since this function works seeing the contents of the first +line, please call this after the second line if possible. + + If you want to apply these trick to other environments, `foo' +environment for example, define the function named +`YaTeX-intelligent-newline-foo' to insert corresponding contents. That +function will be called at the beginning of the next line after the +newline is inserted to the current line. Since the function +`YaTeX-indent-line' is designed to indent the current line properly, +calling this function before your code to insert certain contents must be +useful. See the definition of the function +`YaTeX-intelligent-newline-itemize' as an example. + + + +File: yatexe, Node: Usepackage checker, Next: Online help, Prev: Intelligent newline, Up: Top + +Usepackage checker +****************** + +When you input begint-type, section-type, maketitle-type macros with +completion, and it requires some LaTeX2e package, YaTeX examines the +existence of correct `\usepackage'. If not, YaTeX inserts the +`\usepackage{}' declaration corresponding to input macro. + +To activate the package completion for your favarite package, set the +variable `YaTeX-package-alist-private' correctly. Please refere the value +of `YaTeX-package-alist-default' as an example. + + + +File: yatexe, Node: Online help, Next: Browsing file hierarchy, Prev: Usepackage checker, Up: Top + +Online help +*********** + + YaTeX provides you the online help with popular LaTeX commands. + + Here are the key strokes for the online help. + +`[prefix] ?' + ... Online help +`[prefix] /' + ... Online apropos + + +Online help +=========== + + `Online help' shows the documentation for the popular LaTeX +commands(defaults to the commands on the cursor) in the next buffer. +There are two help file, `global help' and `private help'. The former +file contains the descriptions on the standard LaTeX command and is +specified its name by variable `YaTeX-help-file'. Usually, the global +help file should be located in public space (`$EMACSEXECPATH' by default) +and should be world writable so that anyone can update it to enrich its +contents. The latter file contains descriptions on non-standard or +personal command definitions and is specified by +`YaTeX-help-file-private'. This file should be put into private +directory. + + +Online apropos +============== + + `Online apropos' is an equivalent of GNU Emacs's apropos. It shows all +the documentations that contains the keyword entered by the user. + + +When no descriptions are found... +================================= + + If there is no description on a command in help files, YaTeX requires +you to write a description on that command. If you are willing to do, +determine which help file to add and write the description on it referring +your manual of (La)TeX. Please send me your additional descriptions if +you describe the help on some standard commands. I might want to include +it in the next distribution. + + + +File: yatexe, Node: Browsing file hierarchy, Next: Cooperation with other packages, Prev: Online help, Up: Top + +Browsing file hierarchy +*********************** + + When you are editing multi-file source, typing + +`[prefix] d' + ... browse file hierarchy + +asks you the parent-most file (which may be defaulted) and displays the +documentation hierarchy in the next window. In this buffer, the following +commands are available. + +`n' + ... move to the next line and show its contents +`p' + ... move to the previous line and show its contents +`N' + ... move to the next file in the same inclusion level +`P' + ... move to the previous file in the same inclusion level +`j' + ... move to the next line +`k' + ... move to the previous line +`u' + ... move to the parent file +`.' + ... show the current files contents in the next window +`SPC' + ... scroll up the current file window +`DEL, b' + ... scroll down the current file window +`<' + ... show the beginning of the current file +`>' + ... show the end of the current file +`>' + ... return to the previous postion after `<' or `>' +`RET, g' + ... open the current file in the next window +`mouse-2' + ... same as RET(available only with window system) +`o' + ... other window +`1' + ... delete other windows +`-' + ... shrink hierarchy buffer window +`+' + ... enlarge hierarchy buffer window +`?' + ... describe mode +`q' + ... quit + + Note that operations on the file contents in the next window do not work +correctly when you close the corresponding file. + + + +File: yatexe, Node: Cooperation with other packages, Next: Customizations, Prev: Browsing file hierarchy, Up: Top + +Cooperation with other packages +******************************* + + YaTeX works better with other brilliant packages. + + +gmhist +====== + + When you are loading `gmhist.el' and `gmhist-mh.el', you can use +independent command history list at the prompt of preview command +(`[prefix] tp') and print command (`[prefix] tl'). On each prompt, you +can enter the previous command line string repeatedly by typing `M-p'. + + +min-out +======= + + `min-out', the outline minor mode, can be used in yatex-mode buffers. +If you want to use it with YaTeX, please refer the file `yatexm-o.el' as +an example. + + + +File: yatexe, Node: Customizations, Next: Etcetera, Prev: Cooperation with other packages, Up: Top + +Customizations +************** + + You can customize YaTeX by setting Emacs-Lisp variables and by making +add-in functions. + +* Menu: + +* Lisp variables:: +* Add-in functions:: +* Add-in generator:: + + + +File: yatexe, Node: Lisp variables, Next: Add-in functions, Prev: Customizations, Up: Customizations + +Lisp variables +============== + + You can change the key assignments or make completion more comfortable +by setting the values of various variables which control the movement of +yatex-mode. + + For example, if you want to change the prefix key stroke from `C-c' to +any other sequence, set YaTeX-prefix to whatever you want to use. If you +don't want to use the key sequence `C-c letter' which is assumed to be the +user reserved sequence in Emacs world, set `YaTeX-inhibit-prefix-letter' +to `t', and all of the default key bind of `C-c letter' will turn to the +corresponding `C-c C-letter' (but the region based completions that is +invoked with `C-c Capital-letter' remain valid, if you want to disable +those bindings, set that variable to 1 instead of `t'). + +* Menu: + +* All customizable variables:: +* Sample definitions:: +* Hook variables:: +* Hook file:: + + + +File: yatexe, Node: All customizable variables, Next: Sample definitions, Prev: Lisp variables, Up: Lisp variables + +All customizable variables +-------------------------- + + Here are the customizable variables of yatex-mode. Each value setq-ed +in `~/.emacs' is preferred and that of defined in `yatex.el' is neglected. +Parenthesized contents stands for the default value. When you are to +change some of these variables, see more detailed documentation of the +variable by `M-x describe-variable'. + + -- Variable: YaTeX-japan + Set this nil to produce all messages in English (`Depends on Japanese + feature of Emacs') + + -- Variable: YaTeX-kanji-code + Default buffer-file-coding-system for YaTeX modes' buffer. Set this + 0 to no language conversion. Nil to preserve original + coding-system. 1=Shift JIS, 2=JIS, 3=EUC, 4=UTF-8 (`1 or 2') + + -- Variable: YaTeX-prefix + Prefix key stroke (`C-c') + + -- Variable: YaTeX-inhibit-prefix-letter + Change key stroke from `C-c letter' to `C-c C-letter' (`nil') + + -- Variable: YaTeX-fill-prefix + Fill-prefix used in yatex-mode (`nil') + + -- Variable: YaTeX-user-completion-table + Name of user dictionary where learned completion table will be + stored. (`"~/.yatexrc"') + + -- Variable: tex-command + LaTeX typesetter command (`"latex"') + + -- Variable: dvi2-command + Preview command (`"xdvi -geo +0+0 -s 4"') + + -- Variable: dviprint-command-format + Command format to print dvi file (`"dvi2ps %f %t %s | lpr"') + + -- Variable: dviprint-from-format + Start page format of above %f. %b will turn to start page (`"-f %b"') + + -- Variable: dviprint-to-format + End page format of above %t. %e will turn to `end' page (`"-t %e"') + + -- Variable: makeindex-command + Default makeindex command (`"makeindex"' (`"makeind"' on MS-DOS)) + + -- Variable: YaTeX-dvipdf-command + Default command name to convert .dvi to PDF (`"dvipdfmx"') + + -- Variable: YaTeX-need-nonstop + Put `\nonstopmode{}' or not (`nil') + + -- Variable: latex-warning-regexp + Regular expression of warning message latex command puts out + (`"line.* [0-9]*"') + + -- Variable: latex-error-regexp + Regular expression of error message (`"l\\.[1-9][0-9]*"') + + -- Variable: latex-dos-emergency-message + Message latex command running on DOS puts at abort (`"Emergency + stop"') + + -- Variable: YaTeX-item-regexp + Regular expression of item command (`"\\\\item"') + + -- Variable: YaTeX-verb-regexp + Regexp of verb family. Omit \\\\. (`"verb\\*?\\|path"') + + -- Variable: YaTeX-nervous + T for using local dictionary (`t') + + -- Variable: YaTeX-sectioning-regexp + Regexp of LaTeX sectioning command + (`"\\(part\\|chapter\\*?\\|\\(sub\\)*\\(section\\|paragraph\\)\\*?\\)\\b"') + + -- Variable: YaTeX-fill-inhibit-environments + Inhibit fill in these environments (`'("tabular" "tabular*" "array" + "picture" "eqnarray" "eqnarray*" "equation" "math" "displaymath" + "verbatim" "verbatim*")') + + -- Variable: YaTeX-uncomment-once + T for deleting all preceding `%' (`nil') + + -- Variable: YaTeX-close-paren-always + T for always close all parenthesis automatically, `nil' for only eol + (`t') + + -- Variable: YaTeX-auto-math-mode + Switch math-mode automatically (`t') + + -- Variable: YaTeX-math-key-list-private + User defined alist, math-mode-prefix vs completion alist used in + image completion (`nil'). See `yatexmth.el' for the information + about how to define a completion alist. + + -- Variable: YaTeX-default-pop-window-height + Initial height of typesetting buffer when one-window. Number for the + lines of the buffer, numerical string for the percentage of the + screen-height. `nil' for half height (10) + + -- Variable: YaTeX-help-file + Global online help file name + (`$doc-directory/../../site-lisp/YATEXHLP.eng') + + -- Variable: YaTeX-help-file-private + Private online help file name (`"~/YATEXHLP.eng"') + + -- Variable: YaTeX-no-begend-shortcut + Disable [prefix] b ?? shortcut (`nil)' + + -- Variable: YaTeX-hilit-pattern-adjustment-private + List of the list that contain the regular expression and the symbol + of logical meaning of the string that matches the pattern. See also + the value from `(assq 'yatex-mode hilit-patterns-alist)' and the + value of `YaTeX-hilit-pattern-adjustment-default' (and even the + document of hilit19.el). + + -- Variable: YaTeX-sectioning-level + Alist of LaTeX's sectioning command vs its height. + + -- Variable: YaTeX-hierarchy-ignore-heading-regexp + `YaTeX-display-hierarchy' searches for sectioning command first, and + comment line secondary as a file headings. In latter case, ignore lines + that match with regular expression of this variable. Default value of + this variable is RCS header expressions and mode specifying line `-*- xxxx + -*'. + + -- Variable: YaTeX-skip-default-reader + Non-nil for this variable skips the default argument reader of + section-type command when add-in function for it is not defined + (`nil') + + -- Variable: YaTeX-create-file-prefix-g + When typing `prefix g' on the `\include' line, open the target file + even if the file doesn't exist (`nil') + + -- Variable: YaTeX-simple-messages + Simplyfy messages of various completions (`nil') + + -- Variable: YaTeX-hilit-sectioning-face + When hilit19 and yatex19 is active, YaTeX colors the sectioning + commands. This variable specifies the foreground and background + color of `\part' macro. The default value is `'(yellow/dodgerblue + yellow/slateblue)'. The first element of this list is for the screen + when `hilit-background-mode' is `'light', and the second element is + for `'dark'. You should specify both color as `forecolor/backcolor'. + + -- Variable: YaTeX-hilit-sectioning-attenuation-rate + When color mode, this variable specifies how much attenuate the color + density of `\subparagraph' compared with that of `\chapter' (`'(15 + 40)') See also `YaTeX-hilit-sectioning-face'. + + -- Variable: YaTeX-use-AMS-LaTeX + If you use AMS-LaTeX, set to `t' (`nil') + + -- Variable: YaTeX-use-LaTeX2e + If you use LaTeX2e, set to `t' (`t') + + -- Variable: YaTeX-template-file + File name which is automatically inserted at creation + (`~/work/template.tex') + + -- Variable: YaTeX-search-file-from-top-directory + Non-nil means to search input-files from the directory where main + file exists (`t') + + -- Variable: YaTeX-use-font-lock + Use font-lock to fontify buffer or not (`(featurep 'font-lock)' + + -- Variable: YaTeX-use-hilit19 + Use hilit19 to highlight buffer or not (`(featurep 'hilit19)' + + -- Variable: YaTeX-use-italic-bold + YaTeX tries to search italic, bold fontsets or not (`t' if Emacs-20 + or later). This variable is effective only when font-lock is used. + (`(featurep 'hilit19)' + + -- Variable: YaTeX-singlecmd-suffix + Suffix which is always inserted after maketitle-type macros. `"{}"' + is recommended. + + -- Variable: YaTeX-package-alist-private + Alist of LaTeX2e-package name vs. lists of macros in it. Set this + alist properly and YaTeX automatically check the declaratiion of + `usepackage' for corresponding macro, when you input that macro with + completion. If required `usepackage' is not found, YaTeX also + automatically inserts `\usepackage'. Alist is as follows; + '((PackageName1 (completionType ListOfMacro) (completionType + ListOfMacro)) (PackageName2 (completionType ListOfMacro) + (completionType ListOfMacro...))....) completionType is one of `env, + section, maketitle'. Consult the value of + `YaTeX-package-alist-default' as an example. + + -- Variable: YaTeX-tabular-indentation + At indentation by `C-i' in tabular or array environment, YaTeX put + the additional spaces to the normail indentation depth. The number + of additional spaces is the product of YaTeX-tabular-indentation and + the number of column position in tabular. + + -- Variable: YaTeX-noindent-env-regexp + Regexp of environment names that should begin with no indentation. + All verbatime-like environment name should match with. + + -- Variable: YaTeX-ref-default-label-string + Default \\ref time string format. This format is like strftime(3) + but allowed conversion char are as follows; %y -> Last 2 digit of + year, %b -> Month name, %m -> Monthe number(1-12), %d -> Day, %H -> + Hour, %M -> Minute, %S -> Second, %qx -> alphabetical-decimal + conversion of yymmdd. %qX -> alphabetical-decimal conversion of + HHMMSS. Beware defualt label-string should be always unique. So + this format string should have both time part (%H+%M+%S or %qX) and + date part (%y+(%b|%m)+%d or %qx). + + -- Variable: YaTeX-ref-generate-label-function + Function to generate default label string for unnamed \\label{}s. + The function pointed to this value should take two arguments. First + argument is LaTeX macro's name, second is macro's argument. Here is + an example for using this value. + (setq YaTeX-ref-generate-label-function 'my-yatex-generate-label) + (defun my-yatex-generate-label (command value) + (and (string= command "caption") + (re-search-backward "\\\\begin{\\(figure\\|table\\)}" nil t) + (setq command (match-string 1))) + (let ((alist '(("chapter" . "chap") + ("section" . "sec") + ("subsection" . "subsec") + ("figure" . "fig") + ("table" . "tbl")))) + (if (setq command (cdr (assoc command alist))) + (concat command ":" value) + (YaTeX::ref-generate-label nil nil)))) + + + + +File: yatexe, Node: Sample definitions, Next: Hook variables, Prev: All customizable variables, Up: Lisp variables + +Sample definitions +------------------ + + For instance, to change the prefix key stroke to `ESC', and name of the +user dictionary `~/src/emacs/yatexrc', and set `fill-prefix' to single TAB +character, add the following `setq' to `~/.emacs'. + + (setq YaTeX-prefix "\e" + YaTeX-user-completion-table "~/src/emacs/yatexrc" + YaTeX-fill-prefix " ") + + + +File: yatexe, Node: Hook variables, Next: Hook file, Prev: Sample definitions, Up: Lisp variables + +Hook variables +-------------- + + More customizations will be done by the hook-function defined in +hook-variable `yatex-mode-hook'. This is useful to define a shortcut key +sequence to enter some environments other than `document' and `enumerate' +etc. The following statement defines `[prefix] ba' to enter +`\begin{abstract}' ... `=end{abstract}' immediately. + + (setq yatex-mode-hook + '(lambda() (YaTeX-define-begend-key "ba" "abstract"))) + + You should use functions `YaTeX-define-key', or +`YaTeX-define-begend-key' to define all the key sequences of yatex-mode. + + + +File: yatexe, Node: Hook file, Prev: Hook variables, Up: Lisp variables + +Hook file +--------- + + You can stuff all of YaTeX related expressions into a file named +`yatexhks.el' if you have a lot of codes. YaTeX automatically load this +file at the initialization of itself. Using `yatexhks.el' makes +`yatex-mode-load-hook' unnecessary. + + + +File: yatexe, Node: Add-in functions, Next: Add-in generator, Prev: Lisp variables, Up: Customizations + +Add-in functions +================ + + You can easily define a function to input detailed arguments with +completion according to LaTeX environments or commands. + + +What is add-in functions? +------------------------- + + When you input `tabular' environment, don't you think "I want YaTeX to +complete its argument toward my favorite one such as `{|c|c|c|}'..."? +Yes, you can define the function to complete arguments for any environment +and any LaTeX commands. + + +Procedure +--------- + + Here is the procedure to define add-in functions. + 1. Define the function + 2. Put the function into `yatexhks.el' + +* Menu: + +* How the add-in function works:: +* How the function is called:: +* Useful functions for creating add-in:: +* Contribution:: + + + +File: yatexe, Node: How the add-in function works, Next: How the function is called, Prev: Add-in functions, Up: Add-in functions + +How the add-in function works +----------------------------- + +There are three types of add-in. + + 1. Option add-in + 2. argument add-in + 3. enclosing add-in + +"Option add-in" returns the LaTeX's optional parameters such as optional +strings after `\begin{ENV}', optional strings between a section-type +command and its first argument, and optional strings just after type +maketitle-type command. The following illustrates the name of add-in +functions, where underlined strings are generated by add-in functions. + + \begin{table}[ht] (Function name: YaTeX:table) + ~~~~ + \put(100,200){} (Function name: YaTeX:put) + ~~~~~~~~~ + \sum_{i=0}^{n} (Function name: YaTeX:sum) + ~~~~~~~~~~ + + Obviously, the function name is decided by concatenating the prefix +`YaTeX:' and LaTeX command's name. + + Another add-in type is "argument add-in", which completes arguments for +section-type commands. + + \newcommand{\foo}{bar} (Function name: YaTeX::newcommand) + ~~~~ ~~~ + + When the section-type command is inputted, the function named by +concatenating `YaTeX::' and section-type command, is called automatically +with an integer argument which indicates which argument of section-type +command is being read. Thus the add-in should determine the job referring +the value of its argument. + + "enclosing add-in" is for modifying and/or checking the region that will +be enclosed by section-type commands via `[prefix] S'. An enclosing +add-in function will be called with two arguments, beginning of the +enclosed region and end of the region. Suppose you want to enclose the +existing text `(a+b)/c' by `\frac{}'. + + a/c + | | + A B + +You do set-mark-command at point A and then move to point B. Typing +`[prefix] S' and input `frac' enclose the region like this; + + \frac{a/c} + +Normally, the expression `a/c' is translated to `\frac{a}{c}'. An +enclosing add-in is useful for modifying `/' to `}{'. + +* Menu: + +* Defining option-add-in:: +* Defining argument-add-in:: +* Defining enclosing-add-in:: + + + +File: yatexe, Node: Defining option-add-in, Next: Defining argument-add-in, Prev: How the add-in function works, Up: How the add-in function works + +Defining `option add-in' +........................ + + If you want `{|c|c|c|}' for all `tabular' environment, + + (defun YaTeX:tabular () + "{|c|c|c|}") + +is enough. If you want more complicated format, define as below. + + (defun YaTeX:tabular () + "{@{\\vrule width 1pt\\ }|||@{\\ \\vrule width 1pt}}") + +Note that the character `\' must be described as `\\' in Emacs-Lisp. The +next example reads the tabular format from keyboard. + (defun YaTeX:tabular () + (concat "{" (read-string "Rule: ") "}")) + + + +File: yatexe, Node: Defining argument-add-in, Next: Defining enclosing-add-in, Prev: Defining option-add-in, Up: How the add-in function works + +Defining `argument add-in' +.......................... + + This section describes how to define the add-in function for +`\newcommand'. + + The first argument of `\newcommand' begins always with `\'. The second +argument is usually so complex that we can not edit them in the +minibuffer. Here is the created function considering this. + + (defun YaTeX::newcommand (n) ;n is argument position + (cond + ((= n 1) ;1st argument is macro name + (read-string "Command: " "\\")) ;initial input `\' + ((= n 2) "") ;do nothing when reading arg#2 + (t nil))) + + Note that when the `argument add-in' function return `nil', normal +argument reader will be called. + + + +File: yatexe, Node: Defining enclosing-add-in, Prev: Defining argument-add-in, Up: How the add-in function works + +Defining `enclosing add-in' +........................... + + This section describes how to define the add-in function for text +enclosed by `\frac{}'. + + When enclosing the text `5/3' by `\frac{}', you might want to replace +`/' with `}{'. Enclosing function `YaTeX::frac-region' is called with two +arguments, beginning of enclosed text and end of enclosed text. The +function is expected to replace `/' with `}{'. Here is an example +expression. + + (defun YaTeX::frac-region (beg end) + (catch 'done + (while (search-forward "/" end t) + (goto-char (match-beginning 0)) + (if (y-or-n-p "Replace this slash(/) with `}{'") + (throw 'done (replace-match "}{"))) + (goto-char (match-end 0))))) + + + +File: yatexe, Node: How the function is called, Next: Useful functions for creating add-in, Prev: How the add-in function works, Up: Add-in functions + +How the function is called +-------------------------- + + YaTeX calls the add-in functions for specified begin-type, section-type, +and maketitle-type command, if any. `Option add-in' functions for +begin-type are called when `\begin{ENV}' has been inserted, functions for +section-type are called just before input of the first argument, and +functions for maketitle-type is called after maketitle-type command has +been inserted. `Argument add-in' functions are called at each entry of +arguments for section-type commands. + + + +File: yatexe, Node: Useful functions for creating add-in, Next: Contribution, Prev: How the function is called, Up: Add-in functions + +Useful functions for creating add-in +------------------------------------ + + Many add-in functions for typical LaTeX commands are defined in +`yatexadd.el'. Those are also useful as references. Here are the short +descriptions on useful functions, where [F] means function, [A] means +arguments, [D] means description. + +`[F]' + YaTeX:read-position +`[A]' + Character list which can show up in the brackets +`[D]' + Return the location specifier such as `[htb]'. When nothing is + entered, omit [] itself. If the possible characters are "htbp", call + this function as `(YaTeX:read-position "htbp")' + +`[F]' + YaTeX:read-coordinates +`[A]' + Base prompt, X-axis prompt, Y-axis prompt (each optional) +`[D]' + Read the coordinates with the prompt "BasePrompt X-axisPrompt:" for + X-axis, "BasePrompt Y-axisPrompt:" for Y-axis, and return it in the + form of "(X,Y)". The default prompts are `Dimension', `X', `Y' + respectively. + +`[F]' + YaTeX:check-completion-type +`[A]' + One of the symbols: 'begin, 'section, or 'maketitle +`[D]' + Check the current completion type is specified one and cause error + if not. The variable `YaTeX-current-completion-type' holds the symbol + according to the current completion type. + + + +File: yatexe, Node: Contribution, Prev: Useful functions for creating add-in, Up: Add-in functions + +Contribution +------------ + + If you make your own pretty function and you let it be in public, please +send me the function. I'm going to include it in the next release. + + + +File: yatexe, Node: Add-in generator, Prev: Add-in functions, Up: Customizations + +Add-in generator +================ + + First, don't forget to read the section of add-in functions *Note Add-in +functions::. If you easily understand how to define them, there's no need +to read this section. But being not familiar with Emacs-Lisp, when you +don't have clear idea what to do, this section describes how to get YaTeX +make add-in function. + + There are two methods of generation. One is for fully interactive +generator for beginners and another requires little knowledge of +Emacs-Lisp. + + +Generator for beginners +----------------------- + The former generator is called by + `M-x YaTeX-generate' + +strokes. All you have to do is follow the guidances. Defying them may +cases the disaster (I wonder what is it???). So when you make some +mistake, it is recommendable to type `C-g' and start afresh. + + +Simple generator +---------------- + + The latter generator is invoked by the next sequence. `M-x +YaTeX-generate-simple' This generator can make both "option add-in" and +"argument add-in" (*refer the section add-in functions* *Note How the +add-in function works::), whereas `YaTeX-generate' cannot make "argument +addin". + + For example, assume you have the LaTeX command as follows. + + \epsinput[t](250,50){hoge.eps}{plain}{Picture of foo} + (A) (B) (1) (2) (3) + (A)Optional parameter to specify the position + One of t(top), b(bottom), l(left), r(right) + (B)Maximum size of frame + (1)1st argument is filename of EPS file + (2)2nd argument indicates + plain do nothing + frame make frame around image + dframe make double-frame around image + for included EPS file. + (3)Caption for the picture + + Now get start with generation. Typing `M-x YaTeX-generate-simple' +brings the prompt: + (O)ption? (A)rgument? + + +Generating "option add-in" +.......................... + + Since (A), (B) above are optional argument, all we have to do to +complete them is define the option add-in for them. Let's generate the +function to complete (A). + + M-x YaTeX-generate-simple RET + epsinput RET + o + +Typing as above leads the next prompt. + + Read type(1): (S)tring (C)omplete (F)ile ([)option (P)osition co(O)rd. (q)uit + + This asks that "Which type is the completion style of 1st argument?". +Here are the possible completion style. + +`String' + read plain string +`Complete' + read with completion +`File' + read file name +`Option' + read optional string (if string omitted, omit [] too) +`Position' + read positional option (like [htbp]) +`Coord.' + read coordinates +`Quit' + quit from generating + + Since (A) is the optional argument to specify the location of included +EPS file, the completion style is `Position', and the possible characters +are t, b, l, and r. To tell these information to generator, operate as +follows. + + Read type(1).... p + Acceptable characters: tblr RET + + (B) is coordinate. So its completion style is coOrd. We want a prompt +meaning "Maximum size" when completion. + + Read type(2).... o + Prompt for coordinates: Max size RET + + That's all for optional argument. Select quit. + + Read type(3).... q + + Then the generated option add-in function for \epsinput will be shown in +the next window. + + +Generating "argument add-in" +............................ + + Next, create the argument add-in. The arguments for \epsinput are EPS +file name, framing style, and caption string in sequence. + + M-x YaTeX-generate-simple RET + epsinput RET + a + + Above key strokes bring the prompt that asks the number of argument. +Answer it with 3. + + How many arguments?: 3 RET + + Then the generator asks the completion style and prompt for completion. +Answer them. `f' for FileName and prompt string. + + Read type(1).... f + Prompt for argument#1 EPS file name RET + + The second argument is one of selected symbol. So the completion type +is `Completion'. + + Read type(2).... c + Prompt for argument#2 Include style RET + + Then all the candidates ready to be read. Type single RET after +entering all. + + Item[1](RET to exit): plain RET + Item[2](RET to exit): frame RET + Item[3](RET to exit): dframe RET + Item[4](RET to exit): RET + + The following prompt asks whether the entered string must belong to +candidates or not. In this case, since the argument must be one of +`plain', `frame', and `dframe', type `y'. + + Require match? (y or n) y + + The last argument is the caption string for which any completion is +needed. + + Read type(3).... s + Prompt for argument#3 Caption RET + default: Figure of RET + + Finally we'll get the argument add-in in the next window. + + +Contribution +------------ + + If you get your own pretty function and you let it be in public, please +steel yourself in the happy atmosphere and do not send me the function. I +do know it is not fine because it is generated by yatexgen:-p. + + + +File: yatexe, Node: Etcetera, Next: Copying, Prev: Customizations, Up: Top + +Etcetera +******** + + The standard completion tables provided in `yatex.el' contain a few +LaTeX commands I frequently use. This is to lessen the key strokes to +complete entire word, because too many candidates rarely used often cause +too many hits. Therefore always try to use completion in order to enrich +your dictionary, and you will also find `Wild Bird' growing suitable for +your LaTeX style. + + The package name `Wild Bird' is the English translation of Japanese +title `Yachou', which is a trick on words of Japanese. + + + +File: yatexe, Node: Copying, Prev: Etcetera, Up: Top + +Copying +******* + + This program is distributed as a free software. You can +use/copy/modify/redistribute this software freely but with NO warranty to +anything as a result of using this software. Adopting code from this +program is also free. But I would not do contract act. + +Any reports and suggestions are welcome as long as I feel interests in +this software. My possible e-mail address is `yuuji@yatex.org'. (as of +Jan.2004) And there is mailing list for YaTeX. Although the common +language is Japanese, questions in English will be welcome. To join the +ML, send the mail whose subject is `append' to the address +`yatex@yatex.org. If you have some question, please ask to +`yatex-admin@yatex.org'. + + The specification of this software will be surely modified (depending on +my feelings) without notice :-p. + + + HIROSE Yuuji + +Tag table: +Node: Top149 +Node: What is YaTeX?1490 +Node: Main features1863 +Node: Installation3392 +Node: Typesetting4169 +Node: Calling typesetter5299 +Node: Calling previewer7503 +Node: Printing out7864 +Node: %#notation8156 +Node: Changing typesetter8574 +Node: Splitting input files8938 +Node: Static region for typesetting10363 +Node: Lpr format11492 +Node: Controlling which command to invoke12565 +Node: Editing %# notation13158 +Node: Completion13702 +Node: Begin-type completion14262 +Node: Section-type completion17305 +Node: view-sectioning19740 +Node: Large-type completion21320 +Node: Maketitle-type completion22051 +Node: Arbitrary completion22603 +Node: End completion22993 +Node: Accent completion23463 +Node: Image completion24080 +Node: Greek letters completion26337 +Node: Local dictionaries27064 +Node: Commenting out28001 +Node: Cursor jump29460 +Node: Jump to corresponding object29772 +Node: Invoking image processor31173 +Node: Jump to main file32516 +Node: Jumping around the environment32881 +Node: Jumping to last completion position33299 +Node: Changing and Deleting33808 +Node: Changing LaTeX commands34200 +Node: Killing LaTeX commands35377 +Node: Filling36562 +Node: Updation of includeonly38413 +Node: What column39210 +Node: Intelligent newline40295 +Node: Usepackage checker41949 +Node: Online help42540 +Node: Browsing file hierarchy44215 +Node: Cooperation with other packages45952 +Node: Customizations46657 +Node: Lisp variables46991 +Node: All customizable variables47995 +Node: Sample definitions57794 +Node: Hook variables58307 +Node: Hook file59011 +Node: Add-in functions59350 +Node: How the add-in function works60210 +Node: Defining option-add-in62409 +Node: Defining argument-add-in63131 +Node: Defining enclosing-add-in64013 +Node: How the function is called64867 +Node: Useful functions for creating add-in65543 +Node: Contribution66948 +Node: Add-in generator67222 +Node: Etcetera72594 +Node: Copying73199 + +End tag table diff --git a/docs/yatexe.tex b/docs/yatexe.tex index 371a2f7..ac9d9e5 100644 --- a/docs/yatexe.tex +++ b/docs/yatexe.tex @@ -5,7 +5,7 @@ @iftex @c @syncodeindex fn cp -@c Last modified Sun Apr 15 22:51:34 2012 on firestorm +@c Last modified Thu May 10 11:12:44 2012 on firestorm @syncodeindex vr cp @end iftex @@ -15,7 +15,7 @@ @subtitle Yet Another tex-mode for emacs @title Wild Bird @subtitle // YaTeX // -@author @copyright{} 1991-2003 by HIROSE, Yuuji [yuuji@@yatex.org] +@author @copyright{} 1991-2012 by HIROSE, Yuuji [yuuji@@yatex.org] @end titlepage @node Top, What is YaTeX?, (dir), (dir) diff --git a/docs/yatexj b/docs/yatexj index f275797..1507207 100644 --- a/docs/yatexj +++ b/docs/yatexj Binary files differ diff --git a/docs/yatexj.tex b/docs/yatexj.tex index 64b8067..03d7bfc 100644 --- a/docs/yatexj.tex +++ b/docs/yatexj.tex Binary files differ diff --git a/makefile b/makefile index 05e8962..8d04cae 100644 --- a/makefile +++ b/makefile @@ -49,7 +49,7 @@ # make clean to delete all producted files # make ci to check in all # make co to check out all -MVER = 1.75 +MVER = 1.76 LISP = ${LISP18} ${LISP19} YAHTML = yahtml.el COMMON = yatexlib.el yatexprc.el diff --git a/yahtml.el b/yahtml.el index 53ab59f..151ba30 100644 --- a/yahtml.el +++ b/yahtml.el @@ -1,9 +1,9 @@ ;;; -*- Emacs-Lisp -*- ;;; (c) 1994-2012 by HIROSE Yuuji [yuuji(@)yatex.org] -;;; Last modified Thu Feb 9 08:36:16 2012 on firestorm +;;; Last modified Thu May 10 11:06:39 2012 on firestorm ;;; $Id$ -(defconst yahtml-revision-number "1.75" +(defconst yahtml-revision-number "1.76" "Revision number of running yahtml.el") ;;;[Installation] diff --git a/yatex.el b/yatex.el index 20d216d..71179b1 100644 --- a/yatex.el +++ b/yatex.el @@ -1,15 +1,15 @@ ;;; -*- Emacs-Lisp -*- ;;; Yet Another tex-mode for emacs - //�쒹// -;;; yatex.el rev. 1.75.3 +;;; yatex.el rev. 1.76 ;;; (c)1991-2012 by HIROSE Yuuji.[yuuji@yatex.org] -;;; Last modified Thu Feb 9 09:52:41 2012 on firestorm +;;; Last modified Thu May 10 11:06:33 2012 on firestorm ;;; $Id$ ;;; The latest version of this software is always available at; ;;; http://www.yatex.org/ (require 'comment) (require 'yatexlib) -(defconst YaTeX-revision-number "1.75.3" +(defconst YaTeX-revision-number "1.76" "Revision number of running yatex.el") ;---------- Local variables ----------
' �����ꂽ��K�� `
' �����ė~�������B + (`"^\\(body\\|dl\\|blockquote\\)"') + + -- Variable: yahtml-template-file + �V�KHTML�t�@�C���쐬���Ɏ����I�ɑ}�����ė~�����t�@�C�����B + `"~/http/template.html"' + + -- Variable: yahtml-prefer-upcases + �^�O�ɑ啶�����g�������B`nil' + + -- Variable: yahtml-prefer-upcase-attributes + �����w��q�ɑ啶�����g�������B`nil' + + -- Variable: yahtml-server-type + Apache�n�̃T�[�o�𗘗p���Ă���ꍇ�� 'apache ���Z�b�g����B + ./.htaccess ���Q�Ƃ��邩�ǂ��������肷��B`'apache' + + -- Variable: yahtml-apache-access-file + `yahtml-server-type' �� `'apache' �̂Ƃ��ɃA�N�Z�X�����t�@�C�������w + ��B`".htaccess"' + + -- Variable: yahtml-shell-command-option + �V�F���ŕʃR�}���h���N������Ƃ��̃I�v�V�����B + + -- Variable: yahtml-translate-hyphens-when-comment-region + �̈�R�����g�A�E�g������Ƃ��Ɋ��ɑ��݂���n�C�t���� `-' �ɕύX�� + �邩�ǂ����B(`t') + + -- Variable: yahtml-entity-reference-chars-alist + �G���e�B�e�B�Q��(Entity Reference)�ŋL�q���ׂ������Q��`'(?���� . "�G + ���e�B�e�B�\�L")' �Ƃ����`�������alist�ŕ��ׂ�B�f�t�H���g�� + `<', `>', `&', `'', `"' �ɑ���alist���ݒ肳��Ă���̂ŁA�lj������� + ���������L�q����Ηǂ��Bcdr�� `"�G���e�B�e�B�\�L"' �́A�擪�� `&' �� + ������`;' �͊܂߂��ɏ����B + + -- Variable: yahtml-faithful-to-htmllint + �\���`�F�b�J�Ƃ��� htmllint �𗘗p����ꍇ������Ƃ����]�v�ȋȂ� + �ɑ��Ă��x���������̂ŁA������������Ƃ��ɂ͂��̕ϐ���`t'�ɂ���B + + -- Variable: yahtml-use-css + CSS�̕⊮�@�\���g�����ǂ��� (`t') + + -- Variable: yahtml-image-inspection-bytes + �摜�t�@�C���̃T�C�Y�ׂ�Ƃ��ɓǂݍ��ރo�C�g�� (`10000') + + -- Variable: yahtml:img-default-alt-format + ��ALT�����̃f�t�H���g������̏����B%x�͉摜�̕��A%y�͉摜 + �̍����A%s�̓t�@�C���T�C�Y�ɒu������� (`"%xx%y(%sbytes)"') + + -- Variable: yahtml-escape-chars + href�⊮�Ȃǂ̂Ƃ��ɗ\����URL�G���R�[�h���邩; 'ask�̂Ƃ��͊m�F�� + �Ă���u������ (`'ask') + + -- Variable: yahtml-use-font-lock + �\�[�X�̐F�Â��p�b�P�[�W�Ƃ��� font-lock �𗘗p���邩(`(featurep + 'font-lock)') + + -- Variable: yahtml-use-hilit19 + �\�[�X�̐F�Â��p�b�P�[�W�Ƃ��� hilit19 �𗘗p���邩(`(featurep + 'hilit19)') + + -- Variable: yahtml-indentation-boundary + �C���f���g�v�Z��ł����Ă悢���E�ƂȂ鐳�K�\��(`"^\\s *"') + + + +File: yahtmlj, Node: Hook variables, Prev: All customizable variables, Up: Customizations + +hook�ϐ� +======== + + + + +File: yahtmlj, Node: Copying, Next: Concept Index, Prev: Customizations, Up: Top + +��舵�� +******** + + �{�v���O�����̓t���[�\�t�g�E�F�A�ł��B�{�v���O�������g�p���Đ����������� +�錋�ʂɑ��Ă���҂͐ӔC��Ȃ����ƂƂ��܂��B�]�ړ��Ɋւ��Ă͐������� +���܂���B�펯�I�Ɉ����Ă��������B�܂��A�g�p���Ă���|�����C���ł��m�点�� +�������ƁA��҂͊��ŃT�|�[�g�ɗ�ނ��Ƃł��傤�B + + ���A��]�A�o�O�A���z���͊��}�������܂��B�A���� yuuji@yatex.org �� +��(2000�N12������)�B�p���I�Ɏg�p���Ă���������̓��C�����O���X�g�ufj�쒹�� +��v�ɐ���������Ă��������B�������@�ɂ��Ă͖{�p�b�P�[�W�� `docs/htmlqa' +�t�@�C���́u���̑��v�̏͂��䗗���������B + +�d�l�́A�\���Ȃ��m����(�C�������)�ύX����܂�:-p�B + + �L���Y�� + + + + +File: yahtmlj, Node: Concept Index, Prev: Copying, Up: Top + +���� +**** + +* Menu: + +* �J�X�^�}�C�Y[�������܂���]: Customizations. 4. +* �L�[�A�T�C��[������������]: Customizations. 4. +* Demacs: Intro. 4. +* HTML��[HTML��]: Intro. 4. +* LaTeX: Intro. 4. +* Mule: Intro. 4. + + + + +Tag table: +Node: Top151 +Node: Intro620 +Node: Installation899 +Node: yahtml�N���̂��߂̐ݒ�1087 +Node: lint�v���O����/�u���E�U/�C���[�W�����[�A�����̐ݒ�1741 +Node: WWW�y�[�W���p�ϐ��̐ݒ�2241 +Node: Command Invocation3012 +Node: Completion3339 +Node: Jump4323 +Node: Changing and Deleting4722 +Node: �^�O�̕ύX4896 +Node: �����Q�Ƃւ̕ύX5246 +Node: ���W������������URLencode5629 +Node: td����/tr����5863 +Node: CSS Support6492 +Node: CSS-class completion6690 +Node: Reread CSS file7674 +Node: Customizations7896 +Node: All customizable variables8120 +Node: Hook variables11118 +Node: Copying11230 +Node: Concept Index11733 + +End tag table diff --git a/docs/yahtmlj.tex b/docs/yahtmlj.tex index e53ddef..a82e8c0 100644 --- a/docs/yahtmlj.tex +++ b/docs/yahtmlj.tex @@ -5,7 +5,7 @@ @iftex @c @syncodeindex fn cp -@c Last modified Wed Feb 29 09:18:14 2012 on firestorm +@c Last modified Thu May 10 11:13:11 2012 on firestorm @syncodeindex vr cp @end iftex @@ -15,7 +15,7 @@ @subtitle Yet Another html-mode for emacs @title �wHTML���x @subtitle // yahtml // -@author @copyright{} 1994-1997 by HIROSE, Yuuji [yuuji@@yatex.org] +@author @copyright{} 1994-2012 by HIROSE, Yuuji [yuuji@@yatex.org] @end titlepage @node Top, Intro, (dir), (dir) diff --git a/docs/yatexe b/docs/yatexe index 9d700e5..302390c 100644 --- a/docs/yatexe +++ b/docs/yatexe @@ -1,2219 +1,2242 @@ -Info file: yatexe, -*-Text-*- -produced by `texinfo-format-buffer' -from file `yatexe.tex' -using `texinfmt.el' version 2.38 of 3 July 1998. - - - - - - -File: yatexe, Node: Top, Next: What is YaTeX?, Prev: (dir), Up: (dir) - -* Menu: - -* What is YaTeX?:: -* Main features:: What YaTeX can do -* Installation:: Guide to install -* Typesetting:: Call typesetting processes -* %#notation:: Meta-keyword `%#' -* Completion:: Input LaTeX commands with completion -* Local dictionaries:: Directory dependent completion -* Commenting out:: Commenting/uncommenting text -* Cursor jump:: Jumping to related position -* Changing and Deleting:: Changing/deleting certain unit of text -* Filling:: Filling an item or paragraph -* Updation of includeonly:: Free from maintaining includeonly -* What column:: Check what table-column the cursor belong -* Intelligent newline:: Guess requisites of new line -* Usepackage checker:: Selecting correct \usepackage is YaTeX's job -* Online help:: On-line documentation of LaTeX -* Browsing file hierarchy:: Walking through file hierarchy -* Cooperation with other packages:: Work well with gmhist, min-out -* Customizations:: How to breed `Wild Bird' -* Etcetera:: YaTeX is acquisitive. -* Copying:: Redistribution - - - - -File: yatexe, Node: What is YaTeX?, Next: Main features, Prev: Top, Up: Top - -What is YaTeX? -************** - - YaTeX automates typesetting and previewing of LaTeX and enables -completing input of LaTeX mark-up command such as -`\begin{}'..`\end{}'. - - YaTeX also supports Demacs which runs on MS-DOS(386), Mule (Multi -Language Enhancement to GNU Emacs), and latex on DOS. - - - -File: yatexe, Node: Main features, Next: Installation, Prev: What is YaTeX?, Up: Top - -Main features -************* - - * Invocation of typesetter, previewer and related programs(`C-c t') - * Typesetting on static region which is independent from point - * Semiautomatic replacing of `\includeonly' - * Jumping to error line(`C-c '') - * Completing-read of LaTeX commands such as `\begin{}', - `\section' etc. - (`C-c b', `C-c s', `C-c l', `C-c m') - * Enclosing text into LaTeX environments or commands - (`C-u' ABOVEKEYSTROKES) - * Displaying the structure of text at entering sectioning commands - * Lump shifting of sectioning commands (*Note view-sectioning::) - * Learning unknown/new LaTeX commands for the next completion - * Argument reading with a guide for complicated LaTeX commands - * Generating argument-readers for new/unsupported commands(`yatexgen') - * Quick changing or deleting of LaTeX commands(`C-c c', `C-c k') - * Jumping from and to inter-file, begin<->end, ref<->label(`C-c g') - * Blanket commenting out or uncommenting - (`C-c >', `C-c <', `C-c ,', `C-c .') - * Easy input of accent mark, math-mode's commands and Greek letters - (`C-c a', `;', `:') - * Online help for the popular LaTeX commands - (`C-c ?', `C-c /') - * Document files hierarchy browser (`C-c d') - * Adding automatically \usepackage corresponding to inputting LaTeX - macro with completion - * Allow you to forget creating \label{}s, \ref or \cite completion - automatically generate labels. - - - -File: yatexe, Node: Installation, Next: Typesetting, Prev: Main features, Up: Top - -Installation -************ - - Put next two expressions into your `~/.emacs'. - - (setq auto-mode-alist - (cons (cons "\\.tex$" 'yatex-mode) auto-mode-alist)) - (autoload 'yatex-mode "yatex" "Yet Another LaTeX mode" t) - -Next, add certain path name where you put files of YaTeX to your -load-path. If you want to put them in `~/src/emacs', write - - (setq load-path - (cons (expand-file-name "~/src/emacs") load-path)) - -in your `~/.emacs' - - Then, yatex-mode will be automatically loaded when you visit a -file which has extension `.tex'. If yatex-mode is successfully -loaded, mode string on mode line will be turned to "YaTeX". - - - - -File: yatexe, Node: Typesetting, Next: %#notation, Prev: Installation, Up: Top - -Typesetting -*********** - - The prefix key stroke of yatex-mode is `C-c' (Press 'C' with Control -key) by default. If you don't intend to change the prefix key stroke, -assume all `[prefix]' as `C-c' in this document. These key -strokes execute typeset or preview command. - -`[prefix] t j' - ... invoke latex -`[prefix] t r' - ... invoke latex on region -`[prefix] t e' - ... invoke latex on current environment or whole - portion of current formulas in math-mode. -`[prefix] t k' - ... kill current typesetting process -`[prefix] t b' - ... invoke bibtex -`[prefix] t i' - ... invoke makeindex -`[prefix] t d' - ... invoke latex && dvipdfmx -`[prefix] t p' - ... preview -`[prefix] t l' - ... lpr dvi-file -`[prefix] t s' - ... search current string on xdvi-remote - -* Menu: - -* Calling typesetter:: -* Calling previewer:: -* Printing out:: - - - -File: yatexe, Node: Calling typesetter, Next: Calling previewer, Prev: Typesetting, Up: Typesetting - -Calling typesetter -================== - - Typing `[prefix] t j', the current editing window will be divided -horizontally when you invoke latex command, and log message of LaTeX -typesetting will be displayed in the other window; called typesetting -buffer. The typesetting buffer automatically scrolls up and traces LaTeX -warnings and error messages. If you see latex stopping by an error, you -can send string to latex in the typesetting buffer. - - If an error stops the LaTeX typesetting, this key stroke will move the -cursor to the line where LaTeX error is detected. - -`[prefix] '' -`([prefix]+single quotation)' - - ... jump to the previous error or warning - - If you find a noticeable error, move to the typesetting buffer and move -the cursor on the line of error message and type `SPACE' key. This makes -the cursor move to corresponding source line. - - YaTeX-typeset-region invoked by `[prefix] tr' call typesetter for -region. The region is specified by standard point and mark, or by -`%#BEGIN' and `%#END' marks. Selected region will be copied to the -temporary file `texput.tex' with the same preamble as the main file of -current editing sources. Be sure to put all local macro settings in -preamble, not after `\begin{document}'. The method of specification of -the region is shown in the section *Note %#notation::. - - The documentclass for typeset-region is the same as that of editing file -if you edit one file, and is the same as main file's if you edit splitting -files. - - The `[prefix] te' key automatically marks current inner environment or -inner math mode and then call typeset-region with marked region. This is -convenient to quick view of current tabular environment or current editing -formulas. Keeping previewer window for `texput.dvi' is handy for -debugging. Since `[prefix] te' selects the inner-most environment as -region, it is not suitable for partial typesetting of doubly or more -composed environment. If you want to do partial typesetting for a nested -environment, use `[prefix] tr' for static-region, which is described in -the section *Note %#notation::. - - - -File: yatexe, Node: Calling previewer, Next: Printing out, Prev: Calling typesetter, Up: Typesetting - -Calling previewer -================= - - `[prefix] t p' invokes the TeX previewer. And if you are using -xdvi-remote, which can be controled from other terminals, `[prefix] t s' -enables you to search current string at the cursor on the running xdvi -window. - - - -File: yatexe, Node: Printing out, Prev: Calling previewer, Up: Typesetting - -Printing out -============ - - When you type `[preifx] t l', YaTeX asks you the range of dvi-printing -by default. You can skip this by invoking it with universal-argument as -follows: - - C-u [prefix] tl - - - -File: yatexe, Node: %#notation, Next: Completion, Prev: Typesetting, Up: Top - -%# notation -*********** - - You can control the typesetting process by describing `%#' notations in -the source text. - -* Menu: - -* Changing typesetter:: -* Splitting input files:: -* Static region for typesetting:: -* Lpr format:: -* Editing %# notation:: - - - -File: yatexe, Node: Changing typesetter, Next: Splitting input files, Prev: %#notation, Up: %#notation - -To change the `latex' command or to split a source text. -======================================================== - - To change the typesetting command, write - - %#!latex-big - -anywhere in the source text. This is useful for changing typesetter. - - - -File: yatexe, Node: Splitting input files, Next: Static region for typesetting, Prev: Changing typesetter, Up: %#notation - -Splitting input files -===================== - - And if you split the source text and edit subfile that should be -included from main text. - - %#!latex main.tex - -will be helpful to execute latex on main file from sub text buffer. Since -this command line after `%#!' will be sent to shell literally, next -description makes it convenient to use ghostview as dvi-previewer. - - %#!latex main ; dvi2ps main.dvi > main - -Note that YaTeX assumes the component before the last period of the last -word in this line as base name of the main LaTeX source. The `%f' -notation in this line is replaced by main file name, and `%r' replaced by -root name of main file name. If you specify `%f' or `%r', YaTeX always -ask you the name of main file at the first typesetting. - - To make best use of the feature of inter-file jumping by `[prefix] g' -(see *Note Cursor jump::), take described below into consideration. - - * You can put split texts in sub directory, but not in sub directory of - sub directory. - * In the main text, specify the child file name with relative path name - such as \include{chap1/sub}, when you include the file in a - sub-directory. - * In a sub-text, write `%#!latex main.tex' even if `main.tex' is in the - parent directory(not %#!latex ../main.tex). - - - -File: yatexe, Node: Static region for typesetting, Next: Lpr format, Prev: Splitting input files, Up: %#notation - -Static region -============= - - Typeset-region by `[prefix] tr' passes the region between point and mark -to typesetting command by default. But when you want to typeset static -region, enclose the region by `%#BEGIN' and `%#END' as follows. - - %#BEGIN - TheRegionYouWantToTypesetManyTimes - %#END - -This is the rule of deciding the region. - - 1. If there exists %#BEGIN before point, - - 1. If there exists %#END after %#BEGIN, - * From %#BEGIN to %#END. - - 2. If %#END does not exist after %#BEGIN, - * From %#BEGIN to the end of buffer. - - 2. If there does not exist %#BEGIN before point, - * Between point and mark(standard method of Emacs). - - It is useful to write `%#BEGIN' in the previous line of \begin and -`%#END' in the next line of \`end' when you try complex environment such -as `tabular' many times. It is also useful to put only `%#BEGIN' alone at -the middle of very long text. Do not forget to erase `%#BEGIN' `%#END' -pair. - - - -File: yatexe, Node: Lpr format, Next: Editing %# notation, Prev: Static region for typesetting, Up: %#notation - -Lpr format -========== - - Lpr format is specified by three Lisp variables. Here are the default -values of them. - -`(1)dviprint-command-format' - `"dvi2ps %f %t %s | lpr"' -`(2)dviprint-from-format' - `"-f %b"' -`(3)dviprint-to-format' - `"-t %e"' - - On YaTeX-lpr, `%s' in (1) is replaced by the file name of main text, -`%f' by contents of (2), %t by contents of (3). At these replacements, -`%b' in (2) is also replaced by the number of beginning page, `%e' in (3) -is replaced by the number of ending page. But `%f' and `%t' are ignored -when you omit the range of print-out by `C-u [prefix] tl'. - - If you want to change this lpr format temporarily, put a command such as -follows somewhere in the text: - - %#LPR dvi2ps %f %t %s | 4up -page 4 | texfix | lpr -Plp2 - - And if you want YaTeX not to ask you the range of printing out, the next -example may be helpful. - - %#LPR dvi2ps %s | lpr - - - -File: yatexe, Node: Editing %# notation, Prev: Lpr format, Up: %#notation - -Editing %# notation -=================== - - To edit `%#' notation described above, type - -`[prefix] %' - ... editing %# notation menu - -and select one of the entry of the menu as follows. - - !)Edit-%#! B)EGIN-END-region L)Edit-%#LPR - -Type `!' to edit `%#!' entry, `b' to enclose the region with `%#BEGIN' and -`%#END', and `l' to edit `%#LPR' entry. When you type `b', all `%#BEGIN' -and `%#END' are automatically erased. - - - -File: yatexe, Node: Completion, Next: Local dictionaries, Prev: %#notation, Up: Top - -Completion -********** - - YaTeX makes it easy to input the LaTeX commands. There are several -kinds of completion type, begin-type, section-type, large-type, etc... - -* Menu: - -* Begin-type completion:: -* Section-type completion:: -* Large-type completion:: -* Maketitle-type completion:: -* Arbitrary completion:: -* End completion:: -* Accent completion:: -* Image completion:: -* Greek letters completion:: - - - -File: yatexe, Node: Begin-type completion, Next: Section-type completion, Prev: Completion, Up: Completion - -Begin-type completion -===================== - - "Begin-type completion" completes commands of `\begin{env}' ... -`\end{env}'. All of the begin-type completions begin with this key -sequence. - -`[prefix] b' - ... start begin-type completion - -An additional key stroke immediately completes a frequently used LaTeX -`\begin{}'...`\`end'{}' environment. - -`[prefix] b c' - ... `\begin{center}...\end{center}' -`[prefix] b d' - ... `\begin{document}...\end{document}' -`[prefix] b D' - ... `\begin{description}...\end{description}' -`[prefix] b e' - ... `\begin{enumerate}...\end{enumerate}' -`[prefix] b E' - ... `\begin{equation}...\end{equation}' -`[prefix] b i' - ... `\begin{itemize}...\end{itemize}' -`[prefix] b l' - ... `\begin{flushleft}...\end{flushleft}' -`[prefix] b m' - ... `\begin{minipage}...\end{minipage}' -`[prefix] b t' - ... `\begin{tabbing}...\end{tabbing}' -`[prefix] b T' - ... `\begin{tabular}...\end{tabular}' -`[prefix] b^T' - ... `\begin{table}...\end{table}' -`[prefix] b p' - ... `\begin{picture}...\end{picture}' -`[prefix] b q' - ... `\begin{quote}...\end{quote}' -`[prefix] b Q' - ... `\begin{quotation}...\end{quotation}' -`[prefix] b r' - ... `\begin{flushright}...\end{flushright}' -`[prefix] b v' - ... `\begin{verbatim}...\end{verbatim}' -`[prefix] b V' - ... `\begin{verse}...\end{verse}' - - Any other LaTeX environments are made by completing-read of the Emacs -function. - -`[prefix] b SPACE' - ... begin-type completion - -The next message will show up in the minibuffer - - Begin environment(default document): - -by typing `[prefix] b'. Put the wishing environment with completion in -the minibuffer, and `\begin{env}'...\`\end{env}' will be inserted in the -LaTeX source text. If the environment you want to put does not exist in -the YaTeX completion table, it will be registered in the user completion -table. YaTeX automatically saves the user completion table in the user -dictionary file at exiting of emacs. - -At the completion of certain environments, the expected initial entry will -automatically inserted such as `\item' for `itemize' environment. If you -don't want the entry, it can be removed by undoing. - - If you want to enclose some paragraphs which have already been written, -invoke the begin-type completion with changing the case of `b' of key -sequence upper(or invoke it with universal argument by `C-u' prefix). - - The following example encloses a region with `description' environment. - -`[prefix] B D' -`(or ESC 1 [prefix] b D)' -`(or C-u [prefix] b D)' - - ... begin-type completion for region - - This enclosing holds good for the completing input by `[prefix] b SPC'. -`[prefix] B SPC' enclose a region with the environment selected by -completing-read. - - - -File: yatexe, Node: Section-type completion, Next: Large-type completion, Prev: Begin-type completion, Up: Completion - -Section-type completion -======================= - - "Section-type completion" completes section-type commands which take an -argument or more such as `\section{foo}'. To invoke section-type -completion, type - -`[prefix] s' - ... section-type completion - -then the prompt - - (C-v for view) \???{} (default documentclass): - -will show up in the minibuffer. Section-type LaTeX commands are completed -by space key, and the default value is selected when you type nothing in -the minibuffer. - - Next, - - \section{???}: - -prompts you the argument of section-type LaTeX command. For example, the -following inputs - - \???{} (default documentclass): section - \section{???}: Hello world. - -will insert the string - - \section{Hello world.} - -in your LaTeX source. When you neglect argument such as - - (C-v for view) \???{} (default section): vspace* - \vspace*{???}: - -YaTeX puts - - \vspace*{} - -and move the cursor in the braces. - - In LaTeX command, there are commands which take more than one arguments -such as `\addtolength{\topmargin}{8mm}'. To complete these commands, -invoke section-type completion with universal argument as, - - C-u 2 [prefix] s (or ESC 2 [prefix] s) - -and make answers in minibuffer like this. - - (C-v for view) \???{} (default vspace*): addtolength - \addtolength{???}: \topmargin - Argument 2: 8mm - -`\addtolength' and the first argument `\topmargin' can be typed easily by -completing read. Since YaTeX also learns the number of arguments of -section-type command and will ask that many arguments in future -completion, you had better tell the number of arguments to YaTeX at the -first completion of the new word. But you can change the number of -arguments by calling the completion with different universal argument -again. - - - Invoking section-type completion with `[Prefix] S' (Capital `S') -includes the region as the first argument of section-type command. - - The section/large/maketitle type completion can work at the prompt for -the argument of other section-type completion. Nested LaTeX commands are -efficiently read with the recursive completion by typing YaTeX's -completion key sequence in the minibuffer. - -* Menu: - -* view-sectioning:: - - - -File: yatexe, Node: view-sectioning, Prev: Section-type completion, Up: Section-type completion - -view-sectioning ---------------- - - In the minibuffer at the prompt of section-type command completion, -typing `C-v' shows a list of sectioning commands in source text(The line -with `<<--' mark is the nearest sectioning command). Then, default -sectioning command appears in the minibuffer. You can go up/down -sectioning command by typing `C-p'/`C-n', can scrolls up/down the listing -buffer by `C-v'/`M-v', and can hide sectioning commands under certain -level by 0 through 6. Type `?' in the minibuffer of sectioning prompt -for more information. - - You can generate this listing buffer (`*Sectioning Lines*' buffer) by -typing -`M-x YaTeX-section-overview' - ... Generate *Sectioning Lines* buffer - -from the LaTeX source buffer. In this listing buffer, typing `u' on the -sectioning command shifts up the corresponding sectioning command in -source text and `d' shifts down. After marking lines in the listing -buffer, typing `U' shifts up all sectioning commands in the region, and -`U' shifts down. Here are all the key bindings of `*Sectioning Lines*' -buffer. - -`SPC' - ... Jump to corresponding source line -`.' - ... Display corresponding source line -`u' - ... Shift up a sectioning line -`d' - ... Shift down a sectioning line -`U' - ... Shift up sectioning lines in region -`D' - ... Shift down sectioning lines in region -`0...6' - ... Hide sectioning commands whose level is lower than n - - - - -File: yatexe, Node: Large-type completion, Next: Maketitle-type completion, Prev: Section-type completion, Up: Completion - -Large-type completion -===================== - - "Large-type completion" inputs the font or size changing descriptions -such as `{\large }'. When you type - -`[prefix] l' - ... large-type completion - -the message in the minibuffer - - {\??? } (default large): - -prompts prompts you large-type command with completing-read. There are -TeX commands to change fonts or sizes, `it', `huge' and so on, in the -completion table. - - Region-based completion is also invoked by changing the letter after -prefix key stroke as `[prefix] L'. It encloses the region by braces with -large-type command. - - - -File: yatexe, Node: Maketitle-type completion, Next: Arbitrary completion, Prev: Large-type completion, Up: Completion - -Maketitle-type completion -========================= - - We call it "maketitle-type completion" which completes commands such as -`\maketitle'. Take notice that maketitle-type commands take no arguments. -Then, typing - -`[prefix] m' - ... maketitle-type completion - -begins maketitle-completion. Above mentioned method is true for -maketitle-completion, and there are LaTeX commands with no arguments in -completion table. - - - -File: yatexe, Node: Arbitrary completion, Next: End completion, Prev: Maketitle-type completion, Up: Completion - -Arbitrary completion -==================== - - You can complete certain LaTeX command anywhere without typical -completing method as described, by typing - -`[prefix] SPC' - ... arbitrary completion - -after the initial string of LaTeX command that is preceded by `\'. - - - -File: yatexe, Node: End completion, Next: Accent completion, Prev: Arbitrary completion, Up: Completion - -End completion -============== - - YaTeX automatically detects the opened environment and close it with -\`\end{environment}'. Though proficient YaTeX users never fail to make -environment with begin-type completion, some may begin an environment -manually. In that case, type - -`[prefix] e' - ... `end' completion - -at the end of the opened environment. - - - -File: yatexe, Node: Accent completion, Next: Image completion, Prev: End completion, Up: Completion - -Accent completion -================= - - When you want to write the European accent marks(like `\`{o}'), - -`[prefix] a' - ... accent completion - -shows the menu - - 1:` 2:' 3:^ 4:" 5:~ 6:= 7:. u v H t c d b - -in the minibuffer. Chose one character or corresponding numeric, and you -will see - - \`{} - -in the editing buffer with the cursor positioned in braces. Type one more -character `o' for example, then - - \`{o} - -will be completed, and the cursor gets out from braces. - - - -File: yatexe, Node: Image completion, Next: Greek letters completion, Prev: Accent completion, Up: Completion - -Image completion of mathematical sign -===================================== - - Arrow marks, sigma mark and those signs mainly used in the TeX's math -environment are completed by key sequences which imitate the corresponding -symbols graphically. This completion only works in the math environment. -YaTeX automatically detects whether the cursor located in math environment -or not, and change the behavior of key strokes `;' and `:'. - - By the way, we often express the leftarrow mark by `<-' for example. -Considering such image, you can write `\leftarrow' by typing `<-' after -`;' (semicolon) as a prefix. In the same way, `\longleftarrow' (`<--') is -completed by typing `;<--', infinity mark which is imitated by `oo' is -completed by typing `;oo'. - - Here are the sample operations in YaTeX math-mode. - - INPUT Completed LaTeX commands - ; < - `\leftarrow' - ; < - - `\longleftarrow' - ; < - - > `\longleftrightarrow' - ; o `\circ' - ; o o `\infty' - - In any case, you can quit from image completion and can move to the next -editing operation if the LaTeX command you want is shown in the buffer. - - `;' itself in math-environment is inserted by `;;'. Typing `TAB' in the -midst of image completion shows all of the LaTeX commands that start with -the same name as string you previously typed in. In this menu buffer, -press `RET' after moving the cursor (by `n', `p', `b', `f') to insert the -LaTeX command. - - To know all of the completion table, type `TAB' just after `;'. And -here is the sample menu by `TAB' after `;<'. - - KEY LaTeX sequence sign - < \leq < - ~ - << \ll << - <- \leftarrow <- - <= \Leftarrow <= - - You can define your favorite key-vs-sequence completion table in the -Emacs-Lisp variable `YaTeX-math-sign-alist-private'. See also -`yatexmth.el' for the information of the structure of this variable. - - - -File: yatexe, Node: Greek letters completion, Prev: Image completion, Up: Completion - -Greek letters completion -======================== - - Math-mode of YaTeX provides another image completion, Greek letters -completion in the same method. After prefix `:', typing `a' makes -`\alpha', `b' makes `\beta' and `g' makes `\gamma' and so on. First, type -`:TAB' to know all the correspondence of alphabets vs. Greek letters. - - If you will find `;' or `:' doesn't work in correct position of math -environment, it may be a bug of YaTeX. Please send me a bug report with -the configuration of your text, and avoid it temporarily by typing `;' or -`:' after universal-argument(`C-u') which forces `;' and `:' to work as -math-prefix. - - - -File: yatexe, Node: Local dictionaries, Next: Commenting out, Prev: Completion, Up: Top - -Local dictionaries -****************** - - Tables for completion consist of three dictionaries; `standard -dictionary' built in `yatex.el', `user dictionary' for your common private -commands, and `local dictionary' that is effective in a certain directory. - - When you input the command unknown to YaTeX at a completion in the -minibuffer, YaTeX asks you with the following prompt; - - `foo' is not in table. Register into: U)serDic L)ocalDic N)one D)iscard - -In this menu, typing `u' updates your `user dictionary', `l' updates your -local dictionary, `n' updates only on-memory dictionary which go through -only current Emacs session, and `d' updates no dictionary and throws the -new word away. - - If you find this switching feature meaningless and bothersome, put the -next expression into your `~/.emacs' - - (setq YaTeX-nervous nil) - - - -File: yatexe, Node: Commenting out, Next: Cursor jump, Prev: Local dictionaries, Up: Top - -Commenting out -************** - - You may want to comment out some region. - -`[prefix] >' - ... comment out region by % -`[prefix] <' - ... uncomment region - -cause an operation to the region between point and mark. - -`[prefix] .' - ... comment out current paragraph -`[prefix] ,' - ... uncomment current paragraph - -comments or uncomments the paragraph where the cursor belongs. This -`paragraph' means the region marked by the function mark-paragraph, bound -to `ESC h' by default. It is NOT predictable what will happen when you -continuously comment out some paragraph many times. - - You can also comment out an environment between `\begin' and `\end', or -a `\begin'-\`\end' pair themselves, by making the following key strokes on -the line where `\begin{}' or `\end{}' exists. - -`[prefix] >' - ... comment out from \begin to \`end' -`[prefix] <' - ... uncomment from \begin to \`end' - -comment whole the contents of environment. Moreover, - -`[prefix] .' - ... comment out \begin and \`end' -`[prefix] ,' - ... uncomment \begin and \`end' - -(un)comments out only environment declaration: `\begin{}' and `\end{}'. -NOTE that even if you intend to comment out some region, invoking -`[prefix] >' on the `\begin',`\end' line decides to work in `commenting -out from `\begin' to `\end'' mode. - - - - -File: yatexe, Node: Cursor jump, Next: Changing and Deleting, Prev: Commenting out, Up: Top - -Cursor jump -*********** - - -* Menu: - -* Jump to corresponding object:: -* Invoking image processor:: -* Jump to main file:: -* Jumping around the environment:: -* Jumping to last completion position:: - - - -File: yatexe, Node: Jump to corresponding object, Next: Invoking image processor, Prev: Cursor jump, Up: Cursor jump - -Jump to corresponding object -============================ - - Typing - -`[prefix] g' - ... go to corresponding object - -in a certain place move the cursor to the place corresponding to the LaTeX -command of last place. YaTeX recognize the followings as pairs that have -relation each other. - - * `\begin{}' <-> `\end{}' - * `%#BEGIN' <-> `%#END' - * On the image-including line -> corresponding viewer or drawing tool - * `\label{}' <-> `\ref{}' - * `\include(\input)' -> included file - * `\bibitem{}' <-> `\cite{}' - - On a `\begin',`\end' line, typing `[prefix] g' moves the cursor to the -corresponding `\end',`\begin' line, if its partner really exists. The -behavior on the line `%#BEGIN' and `%#END' are the same. Note that if the -correspondent of `label/ref' or `cite/bibitem' exists in another file, -that file have to be opened to make a round trip between references by -`[prefix] g'. - - If you type `[prefix] g' on the line of `\include{chap1}', typically in -the main text, YaTeX switches buffer to `chap1.tex'. - -`[prefix] 4 g' - ... go to corresponding object in other window - -do the same job as `[prefix] g' except it's done in other window. Note -that this function doesn't work on `begin/end', `%#BEGIN/%#END' pairs -because it is meaningless. - - - -File: yatexe, Node: Invoking image processor, Next: Jump to main file, Prev: Jump to corresponding object, Up: Cursor jump - -Invoking image processor -======================== - - -`image-including line' described above means such lines as -`\epsfile{file=foo.ps}'. If you type `[prefix] g' on that line, YaTeX -automatically searches source of `foo.ps' and invokes image viewer or -drawing tool correspoinding to it. For example; if you draw an image -foo.obj with Tgif and enclose its product named foo.eps by `\epsfile' -command. Typing `[prefix] g' on `\epsfile' line make YaTeX invoke `tgif -foo.obj'. How a processor is choosen is as follows. - - 1. If there is an expression matching with one of the pattern defined in - `YaTeX-processed-file-regexp-alist', extract file name from regexp - group surrounded by \\(\\). (Which group corresponds is written in - the cdr part of each list.) If no matches were found, do nothing. - 2. If there is a pattern as `%PROCESSOR' which is defined in the - variable `YaTeX-file-processor-alist', call that processor giving the - file name with corresponding extension. - 3. If not, check the existence of each file which is supplied the - extension in the cdr part of each list of - `YaTeX-file-processor-alist'. If any, call the corresponding image - viewer or drawing tool. - - - -File: yatexe, Node: Jump to main file, Next: Jumping around the environment, Prev: Invoking image processor, Up: Cursor jump - -Jump to main file -================= - - Typing - -`[prefix] ^' - ... visit main file -`[prefix] 4^' - ... visit main file in other buffer - -in a sub text switch the buffer to the main text specified by `%#!' -notation. - - - -File: yatexe, Node: Jumping around the environment, Next: Jumping to last completion position, Prev: Jump to main file, Up: Cursor jump - -Jumping around the environment -============================== - - And these are the functions which work on the current LaTeX environment: - -`M-C-a' - ... beginning of environment -`M-C-e' - ... `end' of environment -`M-C-@' - ... mark environment - - - -File: yatexe, Node: Jumping to last completion position, Prev: Jumping around the environment, Up: Cursor jump - -Jumping to last completion position -=================================== - -YaTeX always memorize the position of completion into register `3'. So -every time you make a trip to any other part of text other than you are -writing, you can return to the editing paragraph by calling -register-to-point with argument YaTeX-current-position-register, which is -achieved by typing `C-x j 3'(by default). - - - -File: yatexe, Node: Changing and Deleting, Next: Filling, Prev: Cursor jump, Up: Top - -Changing and Deleting -********************* - - These functions are for change or deletion of LaTeX commands already -entered. - -`[prefix] c' - ... change LaTeX command -`[prefix] k' - ... kill LaTeX command - -* Menu: - -* Changing LaTeX commands:: -* Killing LaTeX commands:: - - - -File: yatexe, Node: Changing LaTeX commands, Next: Killing LaTeX commands, Prev: Changing and Deleting, Up: Changing and Deleting - -Changing LaTeX commands -======================= - -`[prefix] c' can change the various (La)TeX commands. This can change the -followings. - * Environment names - * Section-type commands - * Argument of section-type commands - * Optional parameters (enclosed by []) of section-type commands - * Font/size designators - * Math-mode's maketitle-type commands that can be inputted with image - completion - - Typing `[prefix] c' on one of above objects you want to change brings a -suitable reading function sometimes with completion. Note: If you want to -change the argument of section-type command that contains other LaTeX -commands, type `[prefix] c' either of surrounding braces of the argument -in order to make YaTeX ignore the internal LaTeX sequences as an object of -changing. Anyway, it is very difficult to know which argument position -the cursor belongs because the LaTeX commands can be nested and braces can -freely emerge. So keep it mind to put the cursor on a brace when you are -thinking of changing a complicated argument. - - - -File: yatexe, Node: Killing LaTeX commands, Prev: Changing LaTeX commands, Up: Changing and Deleting - -Killing LaTeX commands -====================== - - `[prefix] k' kills the LaTeX commands sometimes with their arguments. -Following table illustrates the correspondence of the invoking position -and what is killed. - - [Invoking position] [action] - \begin, \end line kill \begin,\end pairs - %#BEGIN, %#END line kill %#BEGIN,%#END pairs - on a Section-type command kill section-type command - on a parenthesis kill parentheses - -Note that when killing `\begin, \end' or `%#BEGIN, %#END' pair, the lines -`\begin, \end' or `%#BEGIN, %#END' exist will be killed entirely. So take -care not to create any line that contains more than one `\begin' or so. - -While all operations above are to kill `containers' which surround some -text, universal argument (`C-u') for these commands kills not only -`containers' but also `contents' of them. See below as a sample. - - Original text: [prefix] k C-u [prefix] k - Main \footnote{note} here. Main note here. Main here. - ~(cursor) - - - -File: yatexe, Node: Filling, Next: Updation of includeonly, Prev: Changing and Deleting, Up: Top - -Filling -******* - - -Filling an item -=============== - - To fill a term (descriptive sentences) of `\item', type - -`M-q' - ... fill item - -on that item. - - YaTeX uses the value of the variable `YaTeX-item-regexp' as the regular -expression to search item header in itemize environment. If you make a -newcommand to itemize terms(e.g. `\underlineitem'), put - - (setq YaTeX-item-regexp - "\\(\\\\\\(sub\\)*item\\)\\|\\(\\\\underlineitem\\)") - -in your `~/.emacs'. If you are not familiar with regular expression for -Emacs-Lisp, name a newcommand for `itemize' beginning with `\item' such as -`\itembf', not `\bfitem'. - - This function reformats the `\item' into `hang-indented' style. For -example: - - itemize, enumerate environment: - > - >\item[foo] `foo' is the typical word for describing an - > arbitrarily written.... - description environment: - > \item[bar] When the word `for' is used as an arbitrarily - > word, `bar' is bound to follow it. - - Note that the indent depth of an `\item' word and its descriptive -paragraph are the same in latter case. If you want to use different -depth, invoke fill-paragraph at the beginning of non-whitespace -character(see below). - - -Filling paragraph -================= - - Fill-paragraph is little bit adapted for LaTeX sources. It retains from -filling in certain environments where formatting leads to a disaster such -as verbatim, tabular, or so. And it protects `\verb' expressions from -being folded (The variable `YaTeX-verb-regexp' controls this). Besides, -putting cursor on the first occurrence of non-whitespace character on a -line changes the fill-prefix temporarily to the depth of the line. - - - -File: yatexe, Node: Updation of includeonly, Next: What column, Prev: Filling, Up: Top - -Updation of `\includeonly' -************************** - - When you edit splitting source texts, the notation - - \includeonly{CurrentEditingFileName} - -in the main file reduces the time of typesetting. If you want to hack -other file a little however, you have to rewrite it to - - \includeonly{OtherFileNameYouWantToFix} - -in the main file. YaTeX automatically detects that the current edited -text is not in includeonly list and prompts you - - A)dd R)eplace %)comment? - -in the minibuffer. Type `a' if you want to add the current file name to -`\includeonly' list, `r' to replace \`includeonly' list with the current -file, and type `%' to comment out the `\includeonly' line. - - - -File: yatexe, Node: What column, Next: Intelligent newline, Prev: Updation of includeonly, Up: Top - -What column? -************ - - We are often get tired of finding the corresponding column in large -tabulars. For example, - - \begin{tabular}{|c|c|c|c|c|c|c|c|}\hline - Name&Position&Post No.&Addr.&Phone No.&FAX No.& - Home Addr.&Home Phone\\ \hline - Thunder Bird & 6 & 223 & LA & xxx-yyy & - zzz-www & Japan & 9876-54321 \\ - & 2 & \multicolumn{2}{c|}{Unknown} - &&&(???) - \\ \hline - \end{tabular} - -Suppose you have the cursor located at `(???)' mark, can you tell which -column it is belonging at once? Maybe no. In such case, type - -`[prefix] &' - ... What column - -in that position. YaTeX tells you the column header of the current field. -Since YaTeX assumes the first line of tabular environment as a row of -column headers, you can create a row of virtual column headers by putting -them in the first line and commenting that line with `%'. - - - -File: yatexe, Node: Intelligent newline, Next: Usepackage checker, Prev: What column, Up: Top - -Intelligent newline -******************* - - At the end of begin-type completion of tabular[*], array, itemize, -enumerate or tabbing environment, or typing - -`ESC RET' - ... Intelligent newline - -in these environments inserts the contents corresponding to the current -environment in the next line. (At the begin-type completion, this -contents can be removed by `undo'.) In `tabular' environment, for -example, `ESC RET' inserts the certain number of `&' and trailing `\\', -and `\hline' if other `\hline' is found in backward. Here are the list of -contents vs. environments. - - * `tabular', `tabular*', `array' - - Corresponding number of `&' and `\\'. And `\hline' if - needed. - - * `tabbing' - - The same number of `\>' as `\=' in the first line. - - * `itemize', `enumerate', `description', `list' - - `\item' or `item[]'. - - Note that since this function works seeing the contents of the first -line, please call this after the second line if possible. - - If you want to apply these trick to other environments, `foo' -environment for example, define the function named -`YaTeX-intelligent-newline-foo' to insert corresponding contents. That -function will be called at the beginning of the next line after the -newline is inserted to the current line. Since the function -`YaTeX-indent-line' is designed to indent the current line properly, -calling this function before your code to insert certain contents must be -useful. See the definition of the function -`YaTeX-intelligent-newline-itemize' as an example. - - - -File: yatexe, Node: Usepackage checker, Next: Online help, Prev: Intelligent newline, Up: Top - -Usepackage checker -****************** - -When you input begint-type, section-type, maketitle-type macros with -completion, and it requires some LaTeX2e package, YaTeX examines the -existence of correct `\usepackage'. If not, YaTeX inserts the -`\usepackage{}' declaration corresponding to input macro. - -To activate the package completion for your favarite package, set the -variable `YaTeX-package-alist-private' correctly. Please refere the value -of `YaTeX-package-alist-default' as an example. - - - -File: yatexe, Node: Online help, Next: Browsing file hierarchy, Prev: Usepackage checker, Up: Top - -Online help -*********** - - YaTeX provides you the online help with popular LaTeX commands. - - Here are the key strokes for the online help. - -`[prefix] ?' - ... Online help -`[prefix] /' - ... Online apropos - - -Online help -=========== - - `Online help' shows the documentation for the popular LaTeX -commands(defaults to the commands on the cursor) in the next buffer. -There are two help file, `global help' and `private help'. The former -file contains the descriptions on the standard LaTeX command and is -specified its name by variable `YaTeX-help-file'. Usually, the global -help file should be located in public space (`$EMACSEXECPATH' by default) -and should be world writable so that anyone can update it to enrich its -contents. The latter file contains descriptions on non-standard or -personal command definitions and is specified by -`YaTeX-help-file-private'. This file should be put into private -directory. - - -Online apropos -============== - - `Online apropos' is an equivalent of GNU Emacs's apropos. It shows all -the documentations that contains the keyword entered by the user. - - -When no descriptions are found... -================================= - - If there is no description on a command in help files, YaTeX requires -you to write a description on that command. If you are willing to do, -determine which help file to add and write the description on it referring -your manual of (La)TeX. Please send me your additional descriptions if -you describe the help on some standard commands. I might want to include -it in the next distribution. - - - -File: yatexe, Node: Browsing file hierarchy, Next: Cooperation with other packages, Prev: Online help, Up: Top - -Browsing file hierarchy -*********************** - - When you are editing multi-file source, typing - -`[prefix] d' - ... browse file hierarchy - -asks you the parent-most file (which may be defaulted) and displays the -documentation hierarchy in the next window. In this buffer, the following -commands are available. - -`n' - ... move to the next line and show its contents -`p' - ... move to the previous line and show its contents -`N' - ... move to the next file in the same inclusion level -`P' - ... move to the previous file in the same inclusion level -`j' - ... move to the next line -`k' - ... move to the previous line -`u' - ... move to the parent file -`.' - ... show the current files contents in the next window -`SPC' - ... scroll up the current file window -`DEL, b' - ... scroll down the current file window -`<' - ... show the beginning of the current file -`>' - ... show the end of the current file -`>' - ... return to the previous postion after `<' or `>' -`RET, g' - ... open the current file in the next window -`mouse-2' - ... same as RET(available only with window system) -`o' - ... other window -`1' - ... delete other windows -`-' - ... shrink hierarchy buffer window -`+' - ... enlarge hierarchy buffer window -`?' - ... describe mode -`q' - ... quit - - Note that operations on the file contents in the next window do not work -correctly when you close the corresponding file. - - - -File: yatexe, Node: Cooperation with other packages, Next: Customizations, Prev: Browsing file hierarchy, Up: Top - -Cooperation with other packages -******************************* - - YaTeX works better with other brilliant packages. - - -gmhist -====== - - When you are loading `gmhist.el' and `gmhist-mh.el', you can use -independent command history list at the prompt of preview command -(`[prefix] tp') and print command (`[prefix] tl'). On each prompt, you -can enter the previous command line string repeatedly by typing `M-p'. - - -min-out -======= - - `min-out', the outline minor mode, can be used in yatex-mode buffers. -If you want to use it with YaTeX, please refer the file `yatexm-o.el' as -an example. - - - -File: yatexe, Node: Customizations, Next: Etcetera, Prev: Cooperation with other packages, Up: Top - -Customizations -************** - - You can customize YaTeX by setting Emacs-Lisp variables and by making -add-in functions. - -* Menu: - -* Lisp variables:: -* Add-in functions:: -* Add-in generator:: - - - -File: yatexe, Node: Lisp variables, Next: Add-in functions, Prev: Customizations, Up: Customizations - -Lisp variables -============== - - You can change the key assignments or make completion more comfortable -by setting the values of various variables which control the movement of -yatex-mode. - - For example, if you want to change the prefix key stroke from `C-c' to -any other sequence, set YaTeX-prefix to whatever you want to use. If you -don't want to use the key sequence `C-c letter' which is assumed to be the -user reserved sequence in Emacs world, set `YaTeX-inhibit-prefix-letter' -to `t', and all of the default key bind of `C-c letter' will turn to the -corresponding `C-c C-letter' (but the region based completions that is -invoked with `C-c Capital-letter' remain valid, if you want to disable -those bindings, set that variable to 1 instead of `t'). - -* Menu: - -* All customizable variables:: -* Sample definitions:: -* Hook variables:: -* Hook file:: - - - -File: yatexe, Node: All customizable variables, Next: Sample definitions, Prev: Lisp variables, Up: Lisp variables - -All customizable variables --------------------------- - - Here are the customizable variables of yatex-mode. Each value setq-ed -in `~/.emacs' is preferred and that of defined in `yatex.el' is neglected. -Parenthesized contents stands for the default value. When you are to -change some of these variables, see more detailed documentation of the -variable by `M-x describe-variable'. - - -- Variable: YaTeX-japan - Set this nil to produce all messages in English (`Depends on Japanese - feature of Emacs') - - -- Variable: YaTeX-kanji-code - Default buffer-file-coding-system for YaTeX modes' buffer. Set this - 0 to no language conversion. Nil to preserve original - coding-system. 1=Shift JIS, 2=JIS, 3=EUC, 4=UTF-8 (`1 or 2') - - -- Variable: YaTeX-prefix - Prefix key stroke (`C-c') - - -- Variable: YaTeX-inhibit-prefix-letter - Change key stroke from `C-c letter' to `C-c C-letter' (`nil') - - -- Variable: YaTeX-fill-prefix - Fill-prefix used in yatex-mode (`nil') - - -- Variable: YaTeX-user-completion-table - Name of user dictionary where learned completion table will be - stored. (`"~/.yatexrc"') - - -- Variable: tex-command - LaTeX typesetter command (`"latex"') - - -- Variable: dvi2-command - Preview command (`"xdvi -geo +0+0 -s 4"') - - -- Variable: dviprint-command-format - Command format to print dvi file (`"dvi2ps %f %t %s | lpr"') - - -- Variable: dviprint-from-format - Start page format of above %f. %b will turn to start page (`"-f %b"') - - -- Variable: dviprint-to-format - End page format of above %t. %e will turn to `end' page (`"-t %e"') - - -- Variable: makeindex-command - Default makeindex command (`"makeindex"' (`"makeind"' on MS-DOS)) - - -- Variable: YaTeX-dvipdf-command - Default command name to convert .dvi to PDF (`"dvipdfmx"') - - -- Variable: YaTeX-need-nonstop - Put `\nonstopmode{}' or not (`nil') - - -- Variable: latex-warning-regexp - Regular expression of warning message latex command puts out - (`"line.* [0-9]*"') - - -- Variable: latex-error-regexp - Regular expression of error message (`"l\\.[1-9][0-9]*"') - - -- Variable: latex-dos-emergency-message - Message latex command running on DOS puts at abort (`"Emergency - stop"') - - -- Variable: YaTeX-item-regexp - Regular expression of item command (`"\\\\item"') - - -- Variable: YaTeX-verb-regexp - Regexp of verb family. Omit \\\\. (`"verb\\*?\\|path"') - - -- Variable: YaTeX-nervous - T for using local dictionary (`t') - - -- Variable: YaTeX-sectioning-regexp - Regexp of LaTeX sectioning command - (`"\\(part\\|chapter\\*?\\|\\(sub\\)*\\(section\\|paragraph\\)\\*?\\)\\b"') - - -- Variable: YaTeX-fill-inhibit-environments - Inhibit fill in these environments (`'("tabular" "tabular*" "array" - "picture" "eqnarray" "eqnarray*" "equation" "math" "displaymath" - "verbatim" "verbatim*")') - - -- Variable: YaTeX-uncomment-once - T for deleting all preceding `%' (`nil') - - -- Variable: YaTeX-close-paren-always - T for always close all parenthesis automatically, `nil' for only eol - (`t') - - -- Variable: YaTeX-auto-math-mode - Switch math-mode automatically (`t') - - -- Variable: YaTeX-math-key-list-private - User defined alist, math-mode-prefix vs completion alist used in - image completion (`nil'). See `yatexmth.el' for the information - about how to define a completion alist. - - -- Variable: YaTeX-default-pop-window-height - Initial height of typesetting buffer when one-window. Number for the - lines of the buffer, numerical string for the percentage of the - screen-height. `nil' for half height (10) - - -- Variable: YaTeX-help-file - Global online help file name - (`$doc-directory/../../site-lisp/YATEXHLP.eng') - - -- Variable: YaTeX-help-file-private - Private online help file name (`"~/YATEXHLP.eng"') - - -- Variable: YaTeX-no-begend-shortcut - Disable [prefix] b ?? shortcut (`nil)' - - -- Variable: YaTeX-hilit-pattern-adjustment-private - List of the list that contain the regular expression and the symbol - of logical meaning of the string that matches the pattern. See also - the value from `(assq 'yatex-mode hilit-patterns-alist)' and the - value of `YaTeX-hilit-pattern-adjustment-default' (and even the - document of hilit19.el). - - -- Variable: YaTeX-sectioning-level - Alist of LaTeX's sectioning command vs its height. - - -- Variable: YaTeX-hierarchy-ignore-heading-regexp - `YaTeX-display-hierarchy' searches for sectioning command first, and - comment line secondary as a file headings. In latter case, ignore lines - that match with regular expression of this variable. Default value of - this variable is RCS header expressions and mode specifying line `-*- xxxx - -*'. - - -- Variable: YaTeX-skip-default-reader - Non-nil for this variable skips the default argument reader of - section-type command when add-in function for it is not defined - (`nil') - - -- Variable: YaTeX-create-file-prefix-g - When typing `prefix g' on the `\include' line, open the target file - even if the file doesn't exist (`nil') - - -- Variable: YaTeX-simple-messages - Simplyfy messages of various completions (`nil') - - -- Variable: YaTeX-hilit-sectioning-face - When hilit19 and yatex19 is active, YaTeX colors the sectioning - commands. This variable specifies the foreground and background - color of `\part' macro. The default value is `'(yellow/dodgerblue - yellow/slateblue)'. The first element of this list is for the screen - when `hilit-background-mode' is `'light', and the second element is - for `'dark'. You should specify both color as `forecolor/backcolor'. - - -- Variable: YaTeX-hilit-sectioning-attenuation-rate - When color mode, this variable specifies how much attenuate the color - density of `\subparagraph' compared with that of `\chapter' (`'(15 - 40)') See also `YaTeX-hilit-sectioning-face'. - - -- Variable: YaTeX-use-AMS-LaTeX - If you use AMS-LaTeX, set to `t' (`nil') - - -- Variable: YaTeX-use-LaTeX2e - If you use LaTeX2e, set to `t' (`t') - - -- Variable: YaTeX-template-file - File name which is automatically inserted at creation - (`~/work/template.tex') - - -- Variable: YaTeX-search-file-from-top-directory - Non-nil means to search input-files from the directory where main - file exists (`t') - - -- Variable: YaTeX-use-font-lock - Use font-lock to fontify buffer or not (`(featurep 'font-lock)' - - -- Variable: YaTeX-use-hilit19 - Use hilit19 to highlight buffer or not (`(featurep 'hilit19)' - - -- Variable: YaTeX-use-italic-bold - YaTeX tries to search italic, bold fontsets or not (`t' if Emacs-20 - or later). This variable is effective only when font-lock is used. - (`(featurep 'hilit19)' - - -- Variable: YaTeX-singlecmd-suffix - Suffix which is always inserted after maketitle-type macros. `"{}"' - is recommended. - - -- Variable: YaTeX-package-alist-private - Alist of LaTeX2e-package name vs. lists of macros in it. Set this - alist properly and YaTeX automatically check the declaratiion of - `usepackage' for corresponding macro, when you input that macro with - completion. If required `usepackage' is not found, YaTeX also - automatically inserts `\usepackage'. Alist is as follows; - '((PackageName1 (completionType ListOfMacro) (completionType - ListOfMacro)) (PackageName2 (completionType ListOfMacro) - (completionType ListOfMacro...))....) completionType is one of `env, - section, maketitle'. Consult the value of - `YaTeX-package-alist-default' as an example. - - -- Variable: YaTeX-tabular-indentation - At indentation by `C-i' in tabular or array environment, YaTeX put - the additional spaces to the normail indentation depth. The number - of additional spaces is the product of YaTeX-tabular-indentation and - the number of column position in tabular. - - -- Variable: YaTeX-noindent-env-regexp - Regexp of environment names that should begin with no indentation. - All verbatime-like environment name should match with. - - -- Variable: YaTeX-ref-default-label-string - Default \\ref time string format. This format is like strftime(3) - but allowed conversion char are as follows; %y -> Last 2 digit of - year, %b -> Month name, %m -> Monthe number(1-12), %d -> Day, %H -> - Hour, %M -> Minute, %S -> Second, %qx -> alphabetical-decimal - conversion of yymmdd. %qX -> alphabetical-decimal conversion of - HHMMSS. Beware defualt label-string should be always unique. So - this format string should have both time part (%H+%M+%S or %qX) and - date part (%y+(%b|%m)+%d or %qx). - - -- Variable: YaTeX-ref-generate-label-function - Function to generate default label string for unnamed \\label{}s. - The function pointed to this value should take two arguments. First - argument is LaTeX macro's name, second is macro's argument. Here is - an example for using this value. - (setq YaTeX-ref-generate-label-function 'my-yatex-generate-label) - (defun my-yatex-generate-label (command value) - (and (string= command "caption") - (re-search-backward "\\\\begin{\\(figure\\|table\\)}" nil t) - (setq command (match-string 1))) - (let ((alist '(("chapter" . "chap") - ("section" . "sec") - ("subsection" . "subsec") - ("figure" . "fig") - ("table" . "tbl")))) - (if (setq command (cdr (assoc command alist))) - (concat command ":" value) - (YaTeX::ref-generate-label nil nil)))) - - - - -File: yatexe, Node: Sample definitions, Next: Hook variables, Prev: All customizable variables, Up: Lisp variables - -Sample definitions ------------------- - - For instance, to change the prefix key stroke to `ESC', and name of the -user dictionary `~/src/emacs/yatexrc', and set `fill-prefix' to single TAB -character, add the following `setq' to `~/.emacs'. - - (setq YaTeX-prefix "\e" - YaTeX-user-completion-table "~/src/emacs/yatexrc" - YaTeX-fill-prefix " ") - - - -File: yatexe, Node: Hook variables, Next: Hook file, Prev: Sample definitions, Up: Lisp variables - -Hook variables --------------- - - More customizations will be done by the hook-function defined in -hook-variable `yatex-mode-hook'. This is useful to define a shortcut key -sequence to enter some environments other than `document' and `enumerate' -etc. The following statement defines `[prefix] ba' to enter -`\begin{abstract}' ... `=end{abstract}' immediately. - - (setq yatex-mode-hook - '(lambda() (YaTeX-define-begend-key "ba" "abstract"))) - - You should use functions `YaTeX-define-key', or -`YaTeX-define-begend-key' to define all the key sequences of yatex-mode. - - - -File: yatexe, Node: Hook file, Prev: Hook variables, Up: Lisp variables - -Hook file ---------- - - You can stuff all of YaTeX related expressions into a file named -`yatexhks.el' if you have a lot of codes. YaTeX automatically load this -file at the initialization of itself. Using `yatexhks.el' makes -`yatex-mode-load-hook' unnecessary. - - - -File: yatexe, Node: Add-in functions, Next: Add-in generator, Prev: Lisp variables, Up: Customizations - -Add-in functions -================ - - You can easily define a function to input detailed arguments with -completion according to LaTeX environments or commands. - - -What is add-in functions? -------------------------- - - When you input `tabular' environment, don't you think "I want YaTeX to -complete its argument toward my favorite one such as `{|c|c|c|}'..."? -Yes, you can define the function to complete arguments for any environment -and any LaTeX commands. - - -Procedure ---------- - - Here is the procedure to define add-in functions. - 1. Define the function - 2. Put the function into `yatexhks.el' - -* Menu: - -* How the add-in function works:: -* How the function is called:: -* Useful functions for creating add-in:: -* Contribution:: - - - -File: yatexe, Node: How the add-in function works, Next: How the function is called, Prev: Add-in functions, Up: Add-in functions - -How the add-in function works ------------------------------ - -There are three types of add-in. - - 1. Option add-in - 2. argument add-in - 3. enclosing add-in - -"Option add-in" returns the LaTeX's optional parameters such as optional -strings after `\begin{ENV}', optional strings between a section-type -command and its first argument, and optional strings just after type -maketitle-type command. The following illustrates the name of add-in -functions, where underlined strings are generated by add-in functions. - - \begin{table}[ht] (Function name: YaTeX:table) - ~~~~ - \put(100,200){} (Function name: YaTeX:put) - ~~~~~~~~~ - \sum_{i=0}^{n} (Function name: YaTeX:sum) - ~~~~~~~~~~ - - Obviously, the function name is decided by concatenating the prefix -`YaTeX:' and LaTeX command's name. - - Another add-in type is "argument add-in", which completes arguments for -section-type commands. - - \newcommand{\foo}{bar} (Function name: YaTeX::newcommand) - ~~~~ ~~~ - - When the section-type command is inputted, the function named by -concatenating `YaTeX::' and section-type command, is called automatically -with an integer argument which indicates which argument of section-type -command is being read. Thus the add-in should determine the job referring -the value of its argument. - - "enclosing add-in" is for modifying and/or checking the region that will -be enclosed by section-type commands via `[prefix] S'. An enclosing -add-in function will be called with two arguments, beginning of the -enclosed region and end of the region. Suppose you want to enclose the -existing text `(a+b)/c' by `\frac{}'. - - a/c - | | - A B - -You do set-mark-command at point A and then move to point B. Typing -`[prefix] S' and input `frac' enclose the region like this; - - \frac{a/c} - -Normally, the expression `a/c' is translated to `\frac{a}{c}'. An -enclosing add-in is useful for modifying `/' to `}{'. - -* Menu: - -* Defining option-add-in:: -* Defining argument-add-in:: -* Defining enclosing-add-in:: - - - -File: yatexe, Node: Defining option-add-in, Next: Defining argument-add-in, Prev: How the add-in function works, Up: How the add-in function works - -Defining `option add-in' -........................ - - If you want `{|c|c|c|}' for all `tabular' environment, - - (defun YaTeX:tabular () - "{|c|c|c|}") - -is enough. If you want more complicated format, define as below. - - (defun YaTeX:tabular () - "{@{\\vrule width 1pt\\ }|||@{\\ \\vrule width 1pt}}") - -Note that the character `\' must be described as `\\' in Emacs-Lisp. The -next example reads the tabular format from keyboard. - (defun YaTeX:tabular () - (concat "{" (read-string "Rule: ") "}")) - - - -File: yatexe, Node: Defining argument-add-in, Next: Defining enclosing-add-in, Prev: Defining option-add-in, Up: How the add-in function works - -Defining `argument add-in' -.......................... - - This section describes how to define the add-in function for -`\newcommand'. - - The first argument of `\newcommand' begins always with `\'. The second -argument is usually so complex that we can not edit them in the -minibuffer. Here is the created function considering this. - - (defun YaTeX::newcommand (n) ;n is argument position - (cond - ((= n 1) ;1st argument is macro name - (read-string "Command: " "\\")) ;initial input `\' - ((= n 2) "") ;do nothing when reading arg#2 - (t nil))) - - Note that when the `argument add-in' function return `nil', normal -argument reader will be called. - - - -File: yatexe, Node: Defining enclosing-add-in, Prev: Defining argument-add-in, Up: How the add-in function works - -Defining `enclosing add-in' -........................... - - This section describes how to define the add-in function for text -enclosed by `\frac{}'. - - When enclosing the text `5/3' by `\frac{}', you might want to replace -`/' with `}{'. Enclosing function `YaTeX::frac-region' is called with two -arguments, beginning of enclosed text and end of enclosed text. The -function is expected to replace `/' with `}{'. Here is an example -expression. - - (defun YaTeX::frac-region (beg end) - (catch 'done - (while (search-forward "/" end t) - (goto-char (match-beginning 0)) - (if (y-or-n-p "Replace this slash(/) with `}{'") - (throw 'done (replace-match "}{"))) - (goto-char (match-end 0))))) - - - -File: yatexe, Node: How the function is called, Next: Useful functions for creating add-in, Prev: How the add-in function works, Up: Add-in functions - -How the function is called --------------------------- - - YaTeX calls the add-in functions for specified begin-type, section-type, -and maketitle-type command, if any. `Option add-in' functions for -begin-type are called when `\begin{ENV}' has been inserted, functions for -section-type are called just before input of the first argument, and -functions for maketitle-type is called after maketitle-type command has -been inserted. `Argument add-in' functions are called at each entry of -arguments for section-type commands. - - - -File: yatexe, Node: Useful functions for creating add-in, Next: Contribution, Prev: How the function is called, Up: Add-in functions - -Useful functions for creating add-in ------------------------------------- - - Many add-in functions for typical LaTeX commands are defined in -`yatexadd.el'. Those are also useful as references. Here are the short -descriptions on useful functions, where [F] means function, [A] means -arguments, [D] means description. - -`[F]' - YaTeX:read-position -`[A]' - Character list which can show up in the brackets -`[D]' - Return the location specifier such as `[htb]'. When nothing is - entered, omit [] itself. If the possible characters are "htbp", call - this function as `(YaTeX:read-position "htbp")' - -`[F]' - YaTeX:read-coordinates -`[A]' - Base prompt, X-axis prompt, Y-axis prompt (each optional) -`[D]' - Read the coordinates with the prompt "BasePrompt X-axisPrompt:" for - X-axis, "BasePrompt Y-axisPrompt:" for Y-axis, and return it in the - form of "(X,Y)". The default prompts are `Dimension', `X', `Y' - respectively. - -`[F]' - YaTeX:check-completion-type -`[A]' - One of the symbols: 'begin, 'section, or 'maketitle -`[D]' - Check the current completion type is specified one and cause error - if not. The variable `YaTeX-current-completion-type' holds the symbol - according to the current completion type. - - - -File: yatexe, Node: Contribution, Prev: Useful functions for creating add-in, Up: Add-in functions - -Contribution ------------- - - If you make your own pretty function and you let it be in public, please -send me the function. I'm going to include it in the next release. - - - -File: yatexe, Node: Add-in generator, Prev: Add-in functions, Up: Customizations - -Add-in generator -================ - - First, don't forget to read the section of add-in functions *Note Add-in -functions::. If you easily understand how to define them, there's no need -to read this section. But being not familiar with Emacs-Lisp, when you -don't have clear idea what to do, this section describes how to get YaTeX -make add-in function. - - There are two methods of generation. One is for fully interactive -generator for beginners and another requires little knowledge of -Emacs-Lisp. - - -Generator for beginners ------------------------ - The former generator is called by - `M-x YaTeX-generate' - -strokes. All you have to do is follow the guidances. Defying them may -cases the disaster (I wonder what is it???). So when you make some -mistake, it is recommendable to type `C-g' and start afresh. - - -Simple generator ----------------- - - The latter generator is invoked by the next sequence. `M-x -YaTeX-generate-simple' This generator can make both "option add-in" and -"argument add-in" (*refer the section add-in functions* *Note How the -add-in function works::), whereas `YaTeX-generate' cannot make "argument -addin". - - For example, assume you have the LaTeX command as follows. - - \epsinput[t](250,50){hoge.eps}{plain}{Picture of foo} - (A) (B) (1) (2) (3) - (A)Optional parameter to specify the position - One of t(top), b(bottom), l(left), r(right) - (B)Maximum size of frame - (1)1st argument is filename of EPS file - (2)2nd argument indicates - plain do nothing - frame make frame around image - dframe make double-frame around image - for included EPS file. - (3)Caption for the picture - - Now get start with generation. Typing `M-x YaTeX-generate-simple' -brings the prompt: - (O)ption? (A)rgument? - - -Generating "option add-in" -.......................... - - Since (A), (B) above are optional argument, all we have to do to -complete them is define the option add-in for them. Let's generate the -function to complete (A). - - M-x YaTeX-generate-simple RET - epsinput RET - o - -Typing as above leads the next prompt. - - Read type(1): (S)tring (C)omplete (F)ile ([)option (P)osition co(O)rd. (q)uit - - This asks that "Which type is the completion style of 1st argument?". -Here are the possible completion style. - -`String' - read plain string -`Complete' - read with completion -`File' - read file name -`Option' - read optional string (if string omitted, omit [] too) -`Position' - read positional option (like [htbp]) -`Coord.' - read coordinates -`Quit' - quit from generating - - Since (A) is the optional argument to specify the location of included -EPS file, the completion style is `Position', and the possible characters -are t, b, l, and r. To tell these information to generator, operate as -follows. - - Read type(1).... p - Acceptable characters: tblr RET - - (B) is coordinate. So its completion style is coOrd. We want a prompt -meaning "Maximum size" when completion. - - Read type(2).... o - Prompt for coordinates: Max size RET - - That's all for optional argument. Select quit. - - Read type(3).... q - - Then the generated option add-in function for \epsinput will be shown in -the next window. - - -Generating "argument add-in" -............................ - - Next, create the argument add-in. The arguments for \epsinput are EPS -file name, framing style, and caption string in sequence. - - M-x YaTeX-generate-simple RET - epsinput RET - a - - Above key strokes bring the prompt that asks the number of argument. -Answer it with 3. - - How many arguments?: 3 RET - - Then the generator asks the completion style and prompt for completion. -Answer them. `f' for FileName and prompt string. - - Read type(1).... f - Prompt for argument#1 EPS file name RET - - The second argument is one of selected symbol. So the completion type -is `Completion'. - - Read type(2).... c - Prompt for argument#2 Include style RET - - Then all the candidates ready to be read. Type single RET after -entering all. - - Item[1](RET to exit): plain RET - Item[2](RET to exit): frame RET - Item[3](RET to exit): dframe RET - Item[4](RET to exit): RET - - The following prompt asks whether the entered string must belong to -candidates or not. In this case, since the argument must be one of -`plain', `frame', and `dframe', type `y'. - - Require match? (y or n) y - - The last argument is the caption string for which any completion is -needed. - - Read type(3).... s - Prompt for argument#3 Caption RET - default: Figure of RET - - Finally we'll get the argument add-in in the next window. - - -Contribution ------------- - - If you get your own pretty function and you let it be in public, please -steel yourself in the happy atmosphere and do not send me the function. I -do know it is not fine because it is generated by yatexgen:-p. - - - -File: yatexe, Node: Etcetera, Next: Copying, Prev: Customizations, Up: Top - -Etcetera -******** - - The standard completion tables provided in `yatex.el' contain a few -LaTeX commands I frequently use. This is to lessen the key strokes to -complete entire word, because too many candidates rarely used often cause -too many hits. Therefore always try to use completion in order to enrich -your dictionary, and you will also find `Wild Bird' growing suitable for -your LaTeX style. - - The package name `Wild Bird' is the English translation of Japanese -title `Yachou', which is a trick on words of Japanese. - - - -File: yatexe, Node: Copying, Prev: Etcetera, Up: Top - -Copying -******* - - This program is distributed as a free software. You can -use/copy/modify/redistribute this software freely but with NO warranty to -anything as a result of using this software. Adopting code from this -program is also free. But I would not do contract act. - -Any reports and suggestions are welcome as long as I feel interests in -this software. My possible e-mail address is `yuuji@yatex.org'. (as of -Jan.2004) And there is mailing list for YaTeX. Although the common -language is Japanese, questions in English will be welcome. To join the -ML, send the mail whose subject is `append' to the address -`yatex@yatex.org. If you have some question, please ask to -`yatex-admin@yatex.org'. - - The specification of this software will be surely modified (depending on -my feelings) without notice :-p. - - - HIROSE Yuuji - - -Tag table: -Node: Top146 -Node: What is YaTeX?1487 -Node: Main features1860 -Node: Installation3452 -Node: Typesetting4229 -Node: Calling typesetter5298 -Node: Calling previewer7502 -Node: Printing out7863 -Node: %#notation8155 -Node: Changing typesetter8531 -Node: Splitting input files8895 -Node: Static region for typesetting10319 -Node: Lpr format11448 -Node: Editing %# notation12505 -Node: Completion13024 -Node: Begin-type completion13584 -Node: Section-type completion16627 -Node: view-sectioning19062 -Node: Large-type completion20642 -Node: Maketitle-type completion21373 -Node: Arbitrary completion21925 -Node: End completion22315 -Node: Accent completion22785 -Node: Image completion23402 -Node: Greek letters completion25659 -Node: Local dictionaries26386 -Node: Commenting out27323 -Node: Cursor jump28782 -Node: Jump to corresponding object29094 -Node: Invoking image processor30495 -Node: Jump to main file31838 -Node: Jumping around the environment32203 -Node: Jumping to last completion position32621 -Node: Changing and Deleting33130 -Node: Changing LaTeX commands33522 -Node: Killing LaTeX commands34699 -Node: Filling35884 -Node: Updation of includeonly37735 -Node: What column38532 -Node: Intelligent newline39617 -Node: Usepackage checker41271 -Node: Online help41862 -Node: Browsing file hierarchy43537 -Node: Cooperation with other packages45274 -Node: Customizations45979 -Node: Lisp variables46313 -Node: All customizable variables47317 -Node: Sample definitions57116 -Node: Hook variables57629 -Node: Hook file58333 -Node: Add-in functions58672 -Node: How the add-in function works59532 -Node: Defining option-add-in61731 -Node: Defining argument-add-in62453 -Node: Defining enclosing-add-in63335 -Node: How the function is called64189 -Node: Useful functions for creating add-in64865 -Node: Contribution66270 -Node: Add-in generator66544 -Node: Etcetera71916 -Node: Copying72521 - -End tag table +Info file: yatexe, -*-Text-*- +produced by `texinfo-format-buffer' +from file `yatexe.tex' +using `texinfmt.el' version 2.38 of 3 July 1998. + + + + + + +File: yatexe, Node: Top, Next: What is YaTeX?, Prev: (dir), Up: (dir) + +* Menu: + +* What is YaTeX?:: +* Main features:: What YaTeX can do +* Installation:: Guide to install +* Typesetting:: Call typesetting processes +* %#notation:: Meta-keyword `%#' +* Completion:: Input LaTeX commands with completion +* Local dictionaries:: Directory dependent completion +* Commenting out:: Commenting/uncommenting text +* Cursor jump:: Jumping to related position +* Changing and Deleting:: Changing/deleting certain unit of text +* Filling:: Filling an item or paragraph +* Updation of includeonly:: Free from maintaining includeonly +* What column:: Check what table-column the cursor belong +* Intelligent newline:: Guess requisites of new line +* Usepackage checker:: Selecting correct \usepackage is YaTeX's job +* Online help:: On-line documentation of LaTeX +* Browsing file hierarchy:: Walking through file hierarchy +* Cooperation with other packages:: Work well with gmhist, min-out +* Customizations:: How to breed `Wild Bird' +* Etcetera:: YaTeX is acquisitive. +* Copying:: Redistribution + + + + +File: yatexe, Node: What is YaTeX?, Next: Main features, Prev: Top, Up: Top + +What is YaTeX? +************** + + YaTeX automates typesetting and previewing of LaTeX and enables +completing input of LaTeX mark-up command such as `\begin{}'..`\end{}'. + + YaTeX also supports Demacs which runs on MS-DOS(386), Mule (Multi +Language Enhancement to GNU Emacs), and latex on DOS. + + + +File: yatexe, Node: Main features, Next: Installation, Prev: What is YaTeX?, Up: Top + +Main features +************* + + * Invocation of typesetter, previewer and related programs(`C-c t') + * Typesetting on static region which is independent from point + * Semiautomatic replacing of `\includeonly' + * Jumping to error line(`C-c '') + * Completing-read of LaTeX commands such as `\begin{}', `\section' etc. + (`C-c b', `C-c s', `C-c l', `C-c m') + * Enclosing text into LaTeX environments or commands (`C-u' + ABOVEKEYSTROKES) + * Displaying the structure of text at entering sectioning commands + * Lump shifting of sectioning commands (*Note view-sectioning::) + * Learning unknown/new LaTeX commands for the next completion + * Argument reading with a guide for complicated LaTeX commands + * Generating argument-readers for new/unsupported commands(`yatexgen') + * Quick changing or deleting of LaTeX commands(`C-c c', `C-c k') + * Jumping from and to inter-file, begin<->end, ref<->label(`C-c g') + * Blanket commenting out or uncommenting (`C-c >', `C-c <', `C-c ,', + `C-c .') + * Easy input of accent mark, math-mode's commands and Greek letters + (`C-c a', `;', `:') + * Online help for the popular LaTeX commands (`C-c ?', `C-c /') + * Document files hierarchy browser (`C-c d') + * Adding automatically \usepackage corresponding to inputting LaTeX + macro with completion + * Allow you to forget creating \label{}s, \ref{} or \cite{} completion + automatically generate labels. + + + +File: yatexe, Node: Installation, Next: Typesetting, Prev: Main features, Up: Top + +Installation +************ + + Put next two expressions into your `~/.emacs'. + + (setq auto-mode-alist + (cons (cons "\\.tex$" 'yatex-mode) auto-mode-alist)) + (autoload 'yatex-mode "yatex" "Yet Another LaTeX mode" t) + +Next, add certain path name where you put files of YaTeX to your +load-path. If you want to put them in `~/src/emacs', write + + (setq load-path + (cons (expand-file-name "~/src/emacs") load-path)) + +in your `~/.emacs' + + Then, yatex-mode will be automatically loaded when you visit a file +which has extension `.tex'. If yatex-mode is successfully loaded, mode +string on mode line will be turned to "YaTeX". + + + + +File: yatexe, Node: Typesetting, Next: %#notation, Prev: Installation, Up: Top + +Typesetting +*********** + + The prefix key stroke of yatex-mode is `C-c' (Press 'C' with Control +key) by default. If you don't intend to change the prefix key stroke, +assume all `[prefix]' as `C-c' in this document. These key strokes +execute typeset or preview command. + +`[prefix] t j' + ... invoke latex +`[prefix] t r' + ... invoke latex on region +`[prefix] t e' + ... invoke latex on current environment or whole portion of + current formulas in math-mode. +`[prefix] t d' + ... invoke dvipdfmx after successful typesetting +`[prefix] t k' + ... kill current typesetting process +`[prefix] t b' + ... invoke bibtex +`[prefix] t i' + ... invoke makeindex +`[prefix] t d' + ... invoke latex && dvipdfmx +`[prefix] t p' + ... preview +`[prefix] t l' + ... lpr dvi-file +`[prefix] t s' + ... search current string on xdvi-remote + +* Menu: + +* Calling typesetter:: +* Calling previewer:: +* Printing out:: + + + +File: yatexe, Node: Calling typesetter, Next: Calling previewer, Prev: Typesetting, Up: Typesetting + +Calling typesetter +================== + + Typing `[prefix] t j', the current editing window will be divided +horizontally when you invoke latex command, and log message of LaTeX +typesetting will be displayed in the other window; called typesetting +buffer. The typesetting buffer automatically scrolls up and traces LaTeX +warnings and error messages. If you see latex stopping by an error, you +can send string to latex in the typesetting buffer. + + If an error stops the LaTeX typesetting, this key stroke will move the +cursor to the line where LaTeX error is detected. + +`[prefix] '' +`([prefix]+single quotation)' + + ... jump to the previous error or warning + + If you find a noticeable error, move to the typesetting buffer and move +the cursor on the line of error message and type `SPACE' key. This makes +the cursor move to corresponding source line. + + YaTeX-typeset-region invoked by `[prefix] tr' call typesetter for +region. The region is specified by standard point and mark, or by +`%#BEGIN' and `%#END' marks. Selected region will be copied to the +temporary file `texput.tex' with the same preamble as the main file of +current editing sources. Be sure to put all local macro settings in +preamble, not after `\begin{document}'. The method of specification of +the region is shown in the section *Note %#notation::. + + The documentclass for typeset-region is the same as that of editing file +if you edit one file, and is the same as main file's if you edit splitting +files. + + The `[prefix] te' key automatically marks current inner environment or +inner math mode and then call typeset-region with marked region. This is +convenient to quick view of current tabular environment or current editing +formulas. Keeping previewer window for `texput.dvi' is handy for +debugging. Since `[prefix] te' selects the inner-most environment as +region, it is not suitable for partial typesetting of doubly or more +composed environment. If you want to do partial typesetting for a nested +environment, use `[prefix] tr' for static-region, which is described in +the section *Note %#notation::. + + + +File: yatexe, Node: Calling previewer, Next: Printing out, Prev: Calling typesetter, Up: Typesetting + +Calling previewer +================= + + `[prefix] t p' invokes the TeX previewer. And if you are using +xdvi-remote, which can be controled from other terminals, `[prefix] t s' +enables you to search current string at the cursor on the running xdvi +window. + + + +File: yatexe, Node: Printing out, Prev: Calling previewer, Up: Typesetting + +Printing out +============ + + When you type `[preifx] t l', YaTeX asks you the range of dvi-printing +by default. You can skip this by invoking it with universal-argument as +follows: + + C-u [prefix] tl + + + +File: yatexe, Node: %#notation, Next: Completion, Prev: Typesetting, Up: Top + +%# notation +*********** + + You can control the typesetting process by describing `%#' notations in +the source text. + +* Menu: + +* Changing typesetter:: +* Splitting input files:: +* Static region for typesetting:: +* Lpr format:: +* Controlling which command to invoke:: +* Editing %# notation:: + + + +File: yatexe, Node: Changing typesetter, Next: Splitting input files, Prev: %#notation, Up: %#notation + +To change the `latex' command or to split a source text. +======================================================== + + To change the typesetting command, write + + %#!latex-big + +anywhere in the source text. This is useful for changing typesetter. + + + +File: yatexe, Node: Splitting input files, Next: Static region for typesetting, Prev: Changing typesetter, Up: %#notation + +Splitting input files +===================== + + And if you split the source text and edit subfile that should be +included from main text. + + %#!latex main.tex + +will be helpful to execute latex on main file from sub text buffer. Since +this command line after `%#!' will be sent to shell literally, next +description makes it convenient to use ghostview as dvi-previewer. + + %#!latex main && dvi2ps main.dvi > main + +Note that YaTeX assumes the component before the last period of the last +word in this line as base name of the main LaTeX source. The `%f' +notation in this line is replaced by main file name, and `%r' replaced by +root name of main file name. If you specify `%f' or `%r', YaTeX always +ask you the name of main file at the first typesetting. + + To make best use of the feature of inter-file jumping by `[prefix] g' +(see *Note Cursor jump::), take described below into consideration. + + * You can put split texts in sub directory, but not in sub directory of + sub directory. + * In the main text, specify the child file name with relative path name + such as \include{chap1/sub}, when you include the file in a + sub-directory. + * In a sub-text, write `%#!latex main.tex' even if `main.tex' is in the + parent directory(not %#!latex ../main.tex). + + + +File: yatexe, Node: Static region for typesetting, Next: Lpr format, Prev: Splitting input files, Up: %#notation + +Static region +============= + + Typeset-region by `[prefix] tr' passes the region between point and mark +to typesetting command by default. But when you want to typeset static +region, enclose the region by `%#BEGIN' and `%#END' as follows. + + %#BEGIN + TheRegionYouWantToTypesetManyTimes + %#END + +This is the rule of deciding the region. + + 1. If there exists %#BEGIN before point, + + 1. If there exists %#END after %#BEGIN, + * From %#BEGIN to %#END. + + 2. If %#END does not exist after %#BEGIN, + * From %#BEGIN to the end of buffer. + + 2. If there does not exist %#BEGIN before point, + * Between point and mark(standard method of Emacs). + + It is useful to write `%#BEGIN' in the previous line of \begin and +`%#END' in the next line of \`end' when you try complex environment such +as `tabular' many times. It is also useful to put only `%#BEGIN' alone at +the middle of very long text. Do not forget to erase `%#BEGIN' `%#END' +pair. + + + +File: yatexe, Node: Lpr format, Next: Controlling which command to invoke, Prev: Static region for typesetting, Up: %#notation + +Lpr format +========== + + Lpr format is specified by three Lisp variables. Here are the default +values of them. + +`(1)dviprint-command-format' + `"dvi2ps %f %t %s | lpr"' +`(2)dviprint-from-format' + `"-f %b"' +`(3)dviprint-to-format' + `"-t %e"' + + On YaTeX-lpr, `%s' in (1) is replaced by the file name of main text, +`%f' by contents of (2), %t by contents of (3). At these replacements, +`%b' in (2) is also replaced by the number of beginning page, `%e' in (3) +is replaced by the number of ending page. But `%f' and `%t' are ignored +when you omit the range of print-out by `C-u [prefix] tl'. + + If you want to change this lpr format temporarily, put a command such as +follows somewhere in the text: + + %#LPR dvi2ps %f %t %s | 4up -page 4 | texfix | lpr -Plp2 + + And if you want YaTeX not to ask you the range of printing out, the next +example may be helpful. + + %#LPR dvi2ps %s | lpr + + + +File: yatexe, Node: Controlling which command to invoke, Next: Editing %# notation, Prev: Lpr format, Up: %#notation + +Controlling which command to invoke +=================================== + +These %# notation below can control which command to invoke for LaTeX +related process. + + `%#BIBTEX' + + ... Command line for makeindex ([prefix] t i) + `%#MAKEINDEX' + + ... Command line for bibtex ([prefix] t b) + +If you want to invoke "makeidx hogehoge" to update index, put the next +line some upper place in the source, for example. + + %#MAKEINDEX makeidx hogehoge + + + + +File: yatexe, Node: Editing %# notation, Prev: Controlling which command to invoke, Up: %#notation + +Editing %# notation +=================== + + To edit `%#' notation described above, type + +`[prefix] %' + ... editing %# notation menu + +and select one of the entry of the menu as follows. + + !)Edit-%#! B)EGIN-END-region L)Edit-%#LPR + +Type `!' to edit `%#!' entry, `b' to enclose the region with `%#BEGIN' and +`%#END', and `l' to edit `%#LPR' entry. When you type `b', all `%#BEGIN' +and `%#END' are automatically erased. + + + +File: yatexe, Node: Completion, Next: Local dictionaries, Prev: %#notation, Up: Top + +Completion +********** + + YaTeX makes it easy to input the LaTeX commands. There are several +kinds of completion type, begin-type, section-type, large-type, etc... + +* Menu: + +* Begin-type completion:: +* Section-type completion:: +* Large-type completion:: +* Maketitle-type completion:: +* Arbitrary completion:: +* End completion:: +* Accent completion:: +* Image completion:: +* Greek letters completion:: + + + +File: yatexe, Node: Begin-type completion, Next: Section-type completion, Prev: Completion, Up: Completion + +Begin-type completion +===================== + + "Begin-type completion" completes commands of `\begin{env}' ... +`\end{env}'. All of the begin-type completions begin with this key +sequence. + +`[prefix] b' + ... start begin-type completion + +An additional key stroke immediately completes a frequently used LaTeX +`\begin{}'...`\`end'{}' environment. + +`[prefix] b c' + ... `\begin{center}...\end{center}' +`[prefix] b d' + ... `\begin{document}...\end{document}' +`[prefix] b D' + ... `\begin{description}...\end{description}' +`[prefix] b e' + ... `\begin{enumerate}...\end{enumerate}' +`[prefix] b E' + ... `\begin{equation}...\end{equation}' +`[prefix] b i' + ... `\begin{itemize}...\end{itemize}' +`[prefix] b l' + ... `\begin{flushleft}...\end{flushleft}' +`[prefix] b m' + ... `\begin{minipage}...\end{minipage}' +`[prefix] b t' + ... `\begin{tabbing}...\end{tabbing}' +`[prefix] b T' + ... `\begin{tabular}...\end{tabular}' +`[prefix] b^T' + ... `\begin{table}...\end{table}' +`[prefix] b p' + ... `\begin{picture}...\end{picture}' +`[prefix] b q' + ... `\begin{quote}...\end{quote}' +`[prefix] b Q' + ... `\begin{quotation}...\end{quotation}' +`[prefix] b r' + ... `\begin{flushright}...\end{flushright}' +`[prefix] b v' + ... `\begin{verbatim}...\end{verbatim}' +`[prefix] b V' + ... `\begin{verse}...\end{verse}' + + Any other LaTeX environments are made by completing-read of the Emacs +function. + +`[prefix] b SPACE' + ... begin-type completion + +The next message will show up in the minibuffer + + Begin environment(default document): + +by typing `[prefix] b'. Put the wishing environment with completion in +the minibuffer, and `\begin{env}'...\`\end{env}' will be inserted in the +LaTeX source text. If the environment you want to put does not exist in +the YaTeX completion table, it will be registered in the user completion +table. YaTeX automatically saves the user completion table in the user +dictionary file at exiting of emacs. + +At the completion of certain environments, the expected initial entry will +automatically inserted such as `\item' for `itemize' environment. If you +don't want the entry, it can be removed by undoing. + + If you want to enclose some paragraphs which have already been written, +invoke the begin-type completion with changing the case of `b' of key +sequence upper(or invoke it with universal argument by `C-u' prefix). + + The following example encloses a region with `description' environment. + +`[prefix] B D' +`(or ESC 1 [prefix] b D)' +`(or C-u [prefix] b D)' + + ... begin-type completion for region + + This enclosing holds good for the completing input by `[prefix] b SPC'. +`[prefix] B SPC' enclose a region with the environment selected by +completing-read. + + + +File: yatexe, Node: Section-type completion, Next: Large-type completion, Prev: Begin-type completion, Up: Completion + +Section-type completion +======================= + + "Section-type completion" completes section-type commands which take an +argument or more such as `\section{foo}'. To invoke section-type +completion, type + +`[prefix] s' + ... section-type completion + +then the prompt + + (C-v for view) \???{} (default documentclass): + +will show up in the minibuffer. Section-type LaTeX commands are completed +by space key, and the default value is selected when you type nothing in +the minibuffer. + + Next, + + \section{???}: + +prompts you the argument of section-type LaTeX command. For example, the +following inputs + + \???{} (default documentclass): section + \section{???}: Hello world. + +will insert the string + + \section{Hello world.} + +in your LaTeX source. When you neglect argument such as + + (C-v for view) \???{} (default section): vspace* + \vspace*{???}: + +YaTeX puts + + \vspace*{} + +and move the cursor in the braces. + + In LaTeX command, there are commands which take more than one arguments +such as `\addtolength{\topmargin}{8mm}'. To complete these commands, +invoke section-type completion with universal argument as, + + C-u 2 [prefix] s (or ESC 2 [prefix] s) + +and make answers in minibuffer like this. + + (C-v for view) \???{} (default vspace*): addtolength + \addtolength{???}: \topmargin + Argument 2: 8mm + +`\addtolength' and the first argument `\topmargin' can be typed easily by +completing read. Since YaTeX also learns the number of arguments of +section-type command and will ask that many arguments in future +completion, you had better tell the number of arguments to YaTeX at the +first completion of the new word. But you can change the number of +arguments by calling the completion with different universal argument +again. + + + Invoking section-type completion with `[Prefix] S' (Capital `S') +includes the region as the first argument of section-type command. + + The section/large/maketitle type completion can work at the prompt for +the argument of other section-type completion. Nested LaTeX commands are +efficiently read with the recursive completion by typing YaTeX's +completion key sequence in the minibuffer. + +* Menu: + +* view-sectioning:: + + + +File: yatexe, Node: view-sectioning, Prev: Section-type completion, Up: Section-type completion + +view-sectioning +--------------- + + In the minibuffer at the prompt of section-type command completion, +typing `C-v' shows a list of sectioning commands in source text(The line +with `<<--' mark is the nearest sectioning command). Then, default +sectioning command appears in the minibuffer. You can go up/down +sectioning command by typing `C-p'/`C-n', can scrolls up/down the listing +buffer by `C-v'/`M-v', and can hide sectioning commands under certain +level by 0 through 6. Type `?' in the minibuffer of sectioning prompt +for more information. + + You can generate this listing buffer (`*Sectioning Lines*' buffer) by +typing +`M-x YaTeX-section-overview' + ... Generate *Sectioning Lines* buffer + +from the LaTeX source buffer. In this listing buffer, typing `u' on the +sectioning command shifts up the corresponding sectioning command in +source text and `d' shifts down. After marking lines in the listing +buffer, typing `U' shifts up all sectioning commands in the region, and +`U' shifts down. Here are all the key bindings of `*Sectioning Lines*' +buffer. + +`SPC' + ... Jump to corresponding source line +`.' + ... Display corresponding source line +`u' + ... Shift up a sectioning line +`d' + ... Shift down a sectioning line +`U' + ... Shift up sectioning lines in region +`D' + ... Shift down sectioning lines in region +`0...6' + ... Hide sectioning commands whose level is lower than n + + + + +File: yatexe, Node: Large-type completion, Next: Maketitle-type completion, Prev: Section-type completion, Up: Completion + +Large-type completion +===================== + + "Large-type completion" inputs the font or size changing descriptions +such as `{\large }'. When you type + +`[prefix] l' + ... large-type completion + +the message in the minibuffer + + {\??? } (default large): + +prompts prompts you large-type command with completing-read. There are +TeX commands to change fonts or sizes, `it', `huge' and so on, in the +completion table. + + Region-based completion is also invoked by changing the letter after +prefix key stroke as `[prefix] L'. It encloses the region by braces with +large-type command. + + + +File: yatexe, Node: Maketitle-type completion, Next: Arbitrary completion, Prev: Large-type completion, Up: Completion + +Maketitle-type completion +========================= + + We call it "maketitle-type completion" which completes commands such as +`\maketitle'. Take notice that maketitle-type commands take no arguments. +Then, typing + +`[prefix] m' + ... maketitle-type completion + +begins maketitle-completion. Above mentioned method is true for +maketitle-completion, and there are LaTeX commands with no arguments in +completion table. + + + +File: yatexe, Node: Arbitrary completion, Next: End completion, Prev: Maketitle-type completion, Up: Completion + +Arbitrary completion +==================== + + You can complete certain LaTeX command anywhere without typical +completing method as described, by typing + +`[prefix] SPC' + ... arbitrary completion + +after the initial string of LaTeX command that is preceded by `\'. + + + +File: yatexe, Node: End completion, Next: Accent completion, Prev: Arbitrary completion, Up: Completion + +End completion +============== + + YaTeX automatically detects the opened environment and close it with +\`\end{environment}'. Though proficient YaTeX users never fail to make +environment with begin-type completion, some may begin an environment +manually. In that case, type + +`[prefix] e' + ... `end' completion + +at the end of the opened environment. + + + +File: yatexe, Node: Accent completion, Next: Image completion, Prev: End completion, Up: Completion + +Accent completion +================= + + When you want to write the European accent marks(like `\`{o}'), + +`[prefix] a' + ... accent completion + +shows the menu + + 1:` 2:' 3:^ 4:" 5:~ 6:= 7:. u v H t c d b + +in the minibuffer. Chose one character or corresponding numeric, and you +will see + + \`{} + +in the editing buffer with the cursor positioned in braces. Type one more +character `o' for example, then + + \`{o} + +will be completed, and the cursor gets out from braces. + + + +File: yatexe, Node: Image completion, Next: Greek letters completion, Prev: Accent completion, Up: Completion + +Image completion of mathematical sign +===================================== + + Arrow marks, sigma mark and those signs mainly used in the TeX's math +environment are completed by key sequences which imitate the corresponding +symbols graphically. This completion only works in the math environment. +YaTeX automatically detects whether the cursor located in math environment +or not, and change the behavior of key strokes `;' and `:'. + + By the way, we often express the leftarrow mark by `<-' for example. +Considering such image, you can write `\leftarrow' by typing `<-' after +`;' (semicolon) as a prefix. In the same way, `\longleftarrow' (`<--') is +completed by typing `;<--', infinity mark which is imitated by `oo' is +completed by typing `;oo'. + + Here are the sample operations in YaTeX math-mode. + + INPUT Completed LaTeX commands + ; < - `\leftarrow' + ; < - - `\longleftarrow' + ; < - - > `\longleftrightarrow' + ; o `\circ' + ; o o `\infty' + + In any case, you can quit from image completion and can move to the next +editing operation if the LaTeX command you want is shown in the buffer. + + `;' itself in math-environment is inserted by `;;'. Typing `TAB' in the +midst of image completion shows all of the LaTeX commands that start with +the same name as string you previously typed in. In this menu buffer, +press `RET' after moving the cursor (by `n', `p', `b', `f') to insert the +LaTeX command. + + To know all of the completion table, type `TAB' just after `;'. And +here is the sample menu by `TAB' after `;<'. + + KEY LaTeX sequence sign + < \leq < + ~ + << \ll << + <- \leftarrow <- + <= \Leftarrow <= + + You can define your favorite key-vs-sequence completion table in the +Emacs-Lisp variable `YaTeX-math-sign-alist-private'. See also +`yatexmth.el' for the information of the structure of this variable. + + + +File: yatexe, Node: Greek letters completion, Prev: Image completion, Up: Completion + +Greek letters completion +======================== + + Math-mode of YaTeX provides another image completion, Greek letters +completion in the same method. After prefix `:', typing `a' makes +`\alpha', `b' makes `\beta' and `g' makes `\gamma' and so on. First, type +`:TAB' to know all the correspondence of alphabets vs. Greek letters. + + If you will find `;' or `:' doesn't work in correct position of math +environment, it may be a bug of YaTeX. Please send me a bug report with +the configuration of your text, and avoid it temporarily by typing `;' or +`:' after universal-argument(`C-u') which forces `;' and `:' to work as +math-prefix. + + + +File: yatexe, Node: Local dictionaries, Next: Commenting out, Prev: Completion, Up: Top + +Local dictionaries +****************** + + Tables for completion consist of three dictionaries; `standard +dictionary' built in `yatex.el', `user dictionary' for your common private +commands, and `local dictionary' that is effective in a certain directory. + + When you input the command unknown to YaTeX at a completion in the +minibuffer, YaTeX asks you with the following prompt; + + `foo' is not in table. Register into: U)serDic L)ocalDic N)one D)iscard + +In this menu, typing `u' updates your `user dictionary', `l' updates your +local dictionary, `n' updates only on-memory dictionary which go through +only current Emacs session, and `d' updates no dictionary and throws the +new word away. + + If you find this switching feature meaningless and bothersome, put the +next expression into your `~/.emacs' + + (setq YaTeX-nervous nil) + + + +File: yatexe, Node: Commenting out, Next: Cursor jump, Prev: Local dictionaries, Up: Top + +Commenting out +************** + + You may want to comment out some region. + +`[prefix] >' + ... comment out region by % +`[prefix] <' + ... uncomment region + +cause an operation to the region between point and mark. + +`[prefix] .' + ... comment out current paragraph +`[prefix] ,' + ... uncomment current paragraph + +comments or uncomments the paragraph where the cursor belongs. This +`paragraph' means the region marked by the function mark-paragraph, bound +to `ESC h' by default. It is NOT predictable what will happen when you +continuously comment out some paragraph many times. + + You can also comment out an environment between `\begin' and `\end', or +a `\begin'-\`\end' pair themselves, by making the following key strokes on +the line where `\begin{}' or `\end{}' exists. + +`[prefix] >' + ... comment out from \begin to \`end' +`[prefix] <' + ... uncomment from \begin to \`end' + +comment whole the contents of environment. Moreover, + +`[prefix] .' + ... comment out \begin and \`end' +`[prefix] ,' + ... uncomment \begin and \`end' + +(un)comments out only environment declaration: `\begin{}' and `\end{}'. +NOTE that even if you intend to comment out some region, invoking +`[prefix] >' on the `\begin',`\end' line decides to work in `commenting +out from `\begin' to `\end'' mode. + + + + +File: yatexe, Node: Cursor jump, Next: Changing and Deleting, Prev: Commenting out, Up: Top + +Cursor jump +*********** + + +* Menu: + +* Jump to corresponding object:: +* Invoking image processor:: +* Jump to main file:: +* Jumping around the environment:: +* Jumping to last completion position:: + + + +File: yatexe, Node: Jump to corresponding object, Next: Invoking image processor, Prev: Cursor jump, Up: Cursor jump + +Jump to corresponding object +============================ + + Typing + +`[prefix] g' + ... go to corresponding object + +in a certain place move the cursor to the place corresponding to the LaTeX +command of last place. YaTeX recognize the followings as pairs that have +relation each other. + + * `\begin{}' <-> `\end{}' + * `%#BEGIN' <-> `%#END' + * On the image-including line -> corresponding viewer or drawing tool + * `\label{}' <-> `\ref{}' + * `\include(\input)' -> included file + * `\bibitem{}' <-> `\cite{}' + + On a `\begin',`\end' line, typing `[prefix] g' moves the cursor to the +corresponding `\end',`\begin' line, if its partner really exists. The +behavior on the line `%#BEGIN' and `%#END' are the same. Note that if the +correspondent of `label/ref' or `cite/bibitem' exists in another file, +that file have to be opened to make a round trip between references by +`[prefix] g'. + + If you type `[prefix] g' on the line of `\include{chap1}', typically in +the main text, YaTeX switches buffer to `chap1.tex'. + +`[prefix] 4 g' + ... go to corresponding object in other window + +do the same job as `[prefix] g' except it's done in other window. Note +that this function doesn't work on `begin/end', `%#BEGIN/%#END' pairs +because it is meaningless. + + + +File: yatexe, Node: Invoking image processor, Next: Jump to main file, Prev: Jump to corresponding object, Up: Cursor jump + +Invoking image processor +======================== + + +`image-including line' described above means such lines as +`\epsfile{file=foo.ps}'. If you type `[prefix] g' on that line, YaTeX +automatically searches source of `foo.ps' and invokes image viewer or +drawing tool correspoinding to it. For example; if you draw an image +foo.obj with Tgif and enclose its product named foo.eps by `\epsfile' +command. Typing `[prefix] g' on `\epsfile' line make YaTeX invoke `tgif +foo.obj'. How a processor is choosen is as follows. + + 1. If there is an expression matching with one of the pattern defined in + `YaTeX-processed-file-regexp-alist', extract file name from regexp + group surrounded by \\(\\). (Which group corresponds is written in + the cdr part of each list.) If no matches were found, do nothing. + 2. If there is a pattern as `%PROCESSOR' which is defined in the + variable `YaTeX-file-processor-alist', call that processor giving the + file name with corresponding extension. + 3. If not, check the existence of each file which is supplied the + extension in the cdr part of each list of + `YaTeX-file-processor-alist'. If any, call the corresponding image + viewer or drawing tool. + + + +File: yatexe, Node: Jump to main file, Next: Jumping around the environment, Prev: Invoking image processor, Up: Cursor jump + +Jump to main file +================= + + Typing + +`[prefix] ^' + ... visit main file +`[prefix] 4^' + ... visit main file in other buffer + +in a sub text switch the buffer to the main text specified by `%#!' +notation. + + + +File: yatexe, Node: Jumping around the environment, Next: Jumping to last completion position, Prev: Jump to main file, Up: Cursor jump + +Jumping around the environment +============================== + + And these are the functions which work on the current LaTeX environment: + +`M-C-a' + ... beginning of environment +`M-C-e' + ... `end' of environment +`M-C-@' + ... mark environment + + + +File: yatexe, Node: Jumping to last completion position, Prev: Jumping around the environment, Up: Cursor jump + +Jumping to last completion position +=================================== + +YaTeX always memorize the position of completion into register `3'. So +every time you make a trip to any other part of text other than you are +writing, you can return to the editing paragraph by calling +register-to-point with argument YaTeX-current-position-register, which is +achieved by typing `C-x j 3'(by default). + + + +File: yatexe, Node: Changing and Deleting, Next: Filling, Prev: Cursor jump, Up: Top + +Changing and Deleting +********************* + + These functions are for change or deletion of LaTeX commands already +entered. + +`[prefix] c' + ... change LaTeX command +`[prefix] k' + ... kill LaTeX command + +* Menu: + +* Changing LaTeX commands:: +* Killing LaTeX commands:: + + + +File: yatexe, Node: Changing LaTeX commands, Next: Killing LaTeX commands, Prev: Changing and Deleting, Up: Changing and Deleting + +Changing LaTeX commands +======================= + +`[prefix] c' can change the various (La)TeX commands. This can change the +followings. + * Environment names + * Section-type commands + * Argument of section-type commands + * Optional parameters (enclosed by []) of section-type commands + * Font/size designators + * Math-mode's maketitle-type commands that can be inputted with image + completion + + Typing `[prefix] c' on one of above objects you want to change brings a +suitable reading function sometimes with completion. Note: If you want to +change the argument of section-type command that contains other LaTeX +commands, type `[prefix] c' either of surrounding braces of the argument +in order to make YaTeX ignore the internal LaTeX sequences as an object of +changing. Anyway, it is very difficult to know which argument position +the cursor belongs because the LaTeX commands can be nested and braces can +freely emerge. So keep it mind to put the cursor on a brace when you are +thinking of changing a complicated argument. + + + +File: yatexe, Node: Killing LaTeX commands, Prev: Changing LaTeX commands, Up: Changing and Deleting + +Killing LaTeX commands +====================== + + `[prefix] k' kills the LaTeX commands sometimes with their arguments. +Following table illustrates the correspondence of the invoking position +and what is killed. + + [Invoking position] [action] + \begin, \end line kill \begin,\end pairs + %#BEGIN, %#END line kill %#BEGIN,%#END pairs + on a Section-type command kill section-type command + on a parenthesis kill parentheses + +Note that when killing `\begin, \end' or `%#BEGIN, %#END' pair, the lines +`\begin, \end' or `%#BEGIN, %#END' exist will be killed entirely. So take +care not to create any line that contains more than one `\begin' or so. + +While all operations above are to kill `containers' which surround some +text, universal argument (`C-u') for these commands kills not only +`containers' but also `contents' of them. See below as a sample. + + Original text: [prefix] k C-u [prefix] k + Main \footnote{note} here. Main note here. Main here. + ~(cursor) + + + +File: yatexe, Node: Filling, Next: Updation of includeonly, Prev: Changing and Deleting, Up: Top + +Filling +******* + + +Filling an item +=============== + + To fill a term (descriptive sentences) of `\item', type + +`M-q' + ... fill item + +on that item. + + YaTeX uses the value of the variable `YaTeX-item-regexp' as the regular +expression to search item header in itemize environment. If you make a +newcommand to itemize terms(e.g. `\underlineitem'), put + + (setq YaTeX-item-regexp + "\\(\\\\\\(sub\\)*item\\)\\|\\(\\\\underlineitem\\)") + +in your `~/.emacs'. If you are not familiar with regular expression for +Emacs-Lisp, name a newcommand for `itemize' beginning with `\item' such as +`\itembf', not `\bfitem'. + + This function reformats the `\item' into `hang-indented' style. For +example: + + itemize, enumerate environment: + > + >\item[foo] `foo' is the typical word for describing an + > arbitrarily written.... + description environment: + > \item[bar] When the word `for' is used as an arbitrarily + > word, `bar' is bound to follow it. + + Note that the indent depth of an `\item' word and its descriptive +paragraph are the same in latter case. If you want to use different +depth, invoke fill-paragraph at the beginning of non-whitespace +character(see below). + + +Filling paragraph +================= + + Fill-paragraph is little bit adapted for LaTeX sources. It retains from +filling in certain environments where formatting leads to a disaster such +as verbatim, tabular, or so. And it protects `\verb' expressions from +being folded (The variable `YaTeX-verb-regexp' controls this). Besides, +putting cursor on the first occurrence of non-whitespace character on a +line changes the fill-prefix temporarily to the depth of the line. + + + +File: yatexe, Node: Updation of includeonly, Next: What column, Prev: Filling, Up: Top + +Updation of `\includeonly' +************************** + + When you edit splitting source texts, the notation + + \includeonly{CurrentEditingFileName} + +in the main file reduces the time of typesetting. If you want to hack +other file a little however, you have to rewrite it to + + \includeonly{OtherFileNameYouWantToFix} + +in the main file. YaTeX automatically detects that the current edited +text is not in includeonly list and prompts you + + A)dd R)eplace %)comment? + +in the minibuffer. Type `a' if you want to add the current file name to +`\includeonly' list, `r' to replace \`includeonly' list with the current +file, and type `%' to comment out the `\includeonly' line. + + + +File: yatexe, Node: What column, Next: Intelligent newline, Prev: Updation of includeonly, Up: Top + +What column? +************ + + We are often get tired of finding the corresponding column in large +tabulars. For example, + + \begin{tabular}{|c|c|c|c|c|c|c|c|}\hline + Name&Position&Post No.&Addr.&Phone No.&FAX No.& + Home Addr.&Home Phone\\ \hline + Thunder Bird & 6 & 223 & LA & xxx-yyy & + zzz-www & Japan & 9876-54321 \\ + & 2 & \multicolumn{2}{c|}{Unknown} + &&&(???) + \\ \hline + \end{tabular} + +Suppose you have the cursor located at `(???)' mark, can you tell which +column it is belonging at once? Maybe no. In such case, type + +`[prefix] &' + ... What column + +in that position. YaTeX tells you the column header of the current field. +Since YaTeX assumes the first line of tabular environment as a row of +column headers, you can create a row of virtual column headers by putting +them in the first line and commenting that line with `%'. + + + +File: yatexe, Node: Intelligent newline, Next: Usepackage checker, Prev: What column, Up: Top + +Intelligent newline +******************* + + At the end of begin-type completion of tabular[*], array, itemize, +enumerate or tabbing environment, or typing + +`ESC RET' + ... Intelligent newline + +in these environments inserts the contents corresponding to the current +environment in the next line. (At the begin-type completion, this +contents can be removed by `undo'.) In `tabular' environment, for +example, `ESC RET' inserts the certain number of `&' and trailing `\\', +and `\hline' if other `\hline' is found in backward. Here are the list of +contents vs. environments. + + * `tabular', `tabular*', `array' + + Corresponding number of `&' and `\\'. And `\hline' if + needed. + + * `tabbing' + + The same number of `\>' as `\=' in the first line. + + * `itemize', `enumerate', `description', `list' + + `\item' or `item[]'. + + Note that since this function works seeing the contents of the first +line, please call this after the second line if possible. + + If you want to apply these trick to other environments, `foo' +environment for example, define the function named +`YaTeX-intelligent-newline-foo' to insert corresponding contents. That +function will be called at the beginning of the next line after the +newline is inserted to the current line. Since the function +`YaTeX-indent-line' is designed to indent the current line properly, +calling this function before your code to insert certain contents must be +useful. See the definition of the function +`YaTeX-intelligent-newline-itemize' as an example. + + + +File: yatexe, Node: Usepackage checker, Next: Online help, Prev: Intelligent newline, Up: Top + +Usepackage checker +****************** + +When you input begint-type, section-type, maketitle-type macros with +completion, and it requires some LaTeX2e package, YaTeX examines the +existence of correct `\usepackage'. If not, YaTeX inserts the +`\usepackage{}' declaration corresponding to input macro. + +To activate the package completion for your favarite package, set the +variable `YaTeX-package-alist-private' correctly. Please refere the value +of `YaTeX-package-alist-default' as an example. + + + +File: yatexe, Node: Online help, Next: Browsing file hierarchy, Prev: Usepackage checker, Up: Top + +Online help +*********** + + YaTeX provides you the online help with popular LaTeX commands. + + Here are the key strokes for the online help. + +`[prefix] ?' + ... Online help +`[prefix] /' + ... Online apropos + + +Online help +=========== + + `Online help' shows the documentation for the popular LaTeX +commands(defaults to the commands on the cursor) in the next buffer. +There are two help file, `global help' and `private help'. The former +file contains the descriptions on the standard LaTeX command and is +specified its name by variable `YaTeX-help-file'. Usually, the global +help file should be located in public space (`$EMACSEXECPATH' by default) +and should be world writable so that anyone can update it to enrich its +contents. The latter file contains descriptions on non-standard or +personal command definitions and is specified by +`YaTeX-help-file-private'. This file should be put into private +directory. + + +Online apropos +============== + + `Online apropos' is an equivalent of GNU Emacs's apropos. It shows all +the documentations that contains the keyword entered by the user. + + +When no descriptions are found... +================================= + + If there is no description on a command in help files, YaTeX requires +you to write a description on that command. If you are willing to do, +determine which help file to add and write the description on it referring +your manual of (La)TeX. Please send me your additional descriptions if +you describe the help on some standard commands. I might want to include +it in the next distribution. + + + +File: yatexe, Node: Browsing file hierarchy, Next: Cooperation with other packages, Prev: Online help, Up: Top + +Browsing file hierarchy +*********************** + + When you are editing multi-file source, typing + +`[prefix] d' + ... browse file hierarchy + +asks you the parent-most file (which may be defaulted) and displays the +documentation hierarchy in the next window. In this buffer, the following +commands are available. + +`n' + ... move to the next line and show its contents +`p' + ... move to the previous line and show its contents +`N' + ... move to the next file in the same inclusion level +`P' + ... move to the previous file in the same inclusion level +`j' + ... move to the next line +`k' + ... move to the previous line +`u' + ... move to the parent file +`.' + ... show the current files contents in the next window +`SPC' + ... scroll up the current file window +`DEL, b' + ... scroll down the current file window +`<' + ... show the beginning of the current file +`>' + ... show the end of the current file +`>' + ... return to the previous postion after `<' or `>' +`RET, g' + ... open the current file in the next window +`mouse-2' + ... same as RET(available only with window system) +`o' + ... other window +`1' + ... delete other windows +`-' + ... shrink hierarchy buffer window +`+' + ... enlarge hierarchy buffer window +`?' + ... describe mode +`q' + ... quit + + Note that operations on the file contents in the next window do not work +correctly when you close the corresponding file. + + + +File: yatexe, Node: Cooperation with other packages, Next: Customizations, Prev: Browsing file hierarchy, Up: Top + +Cooperation with other packages +******************************* + + YaTeX works better with other brilliant packages. + + +gmhist +====== + + When you are loading `gmhist.el' and `gmhist-mh.el', you can use +independent command history list at the prompt of preview command +(`[prefix] tp') and print command (`[prefix] tl'). On each prompt, you +can enter the previous command line string repeatedly by typing `M-p'. + + +min-out +======= + + `min-out', the outline minor mode, can be used in yatex-mode buffers. +If you want to use it with YaTeX, please refer the file `yatexm-o.el' as +an example. + + + +File: yatexe, Node: Customizations, Next: Etcetera, Prev: Cooperation with other packages, Up: Top + +Customizations +************** + + You can customize YaTeX by setting Emacs-Lisp variables and by making +add-in functions. + +* Menu: + +* Lisp variables:: +* Add-in functions:: +* Add-in generator:: + + + +File: yatexe, Node: Lisp variables, Next: Add-in functions, Prev: Customizations, Up: Customizations + +Lisp variables +============== + + You can change the key assignments or make completion more comfortable +by setting the values of various variables which control the movement of +yatex-mode. + + For example, if you want to change the prefix key stroke from `C-c' to +any other sequence, set YaTeX-prefix to whatever you want to use. If you +don't want to use the key sequence `C-c letter' which is assumed to be the +user reserved sequence in Emacs world, set `YaTeX-inhibit-prefix-letter' +to `t', and all of the default key bind of `C-c letter' will turn to the +corresponding `C-c C-letter' (but the region based completions that is +invoked with `C-c Capital-letter' remain valid, if you want to disable +those bindings, set that variable to 1 instead of `t'). + +* Menu: + +* All customizable variables:: +* Sample definitions:: +* Hook variables:: +* Hook file:: + + + +File: yatexe, Node: All customizable variables, Next: Sample definitions, Prev: Lisp variables, Up: Lisp variables + +All customizable variables +-------------------------- + + Here are the customizable variables of yatex-mode. Each value setq-ed +in `~/.emacs' is preferred and that of defined in `yatex.el' is neglected. +Parenthesized contents stands for the default value. When you are to +change some of these variables, see more detailed documentation of the +variable by `M-x describe-variable'. + + -- Variable: YaTeX-japan + Set this nil to produce all messages in English (`Depends on Japanese + feature of Emacs') + + -- Variable: YaTeX-kanji-code + Default buffer-file-coding-system for YaTeX modes' buffer. Set this + 0 to no language conversion. Nil to preserve original + coding-system. 1=Shift JIS, 2=JIS, 3=EUC, 4=UTF-8 (`1 or 2') + + -- Variable: YaTeX-prefix + Prefix key stroke (`C-c') + + -- Variable: YaTeX-inhibit-prefix-letter + Change key stroke from `C-c letter' to `C-c C-letter' (`nil') + + -- Variable: YaTeX-fill-prefix + Fill-prefix used in yatex-mode (`nil') + + -- Variable: YaTeX-user-completion-table + Name of user dictionary where learned completion table will be + stored. (`"~/.yatexrc"') + + -- Variable: tex-command + LaTeX typesetter command (`"latex"') + + -- Variable: dvi2-command + Preview command (`"xdvi -geo +0+0 -s 4"') + + -- Variable: dviprint-command-format + Command format to print dvi file (`"dvi2ps %f %t %s | lpr"') + + -- Variable: dviprint-from-format + Start page format of above %f. %b will turn to start page (`"-f %b"') + + -- Variable: dviprint-to-format + End page format of above %t. %e will turn to `end' page (`"-t %e"') + + -- Variable: makeindex-command + Default makeindex command (`"makeindex"' (`"makeind"' on MS-DOS)) + + -- Variable: YaTeX-dvipdf-command + Default command name to convert .dvi to PDF (`"dvipdfmx"') + + -- Variable: YaTeX-need-nonstop + Put `\nonstopmode{}' or not (`nil') + + -- Variable: latex-warning-regexp + Regular expression of warning message latex command puts out + (`"line.* [0-9]*"') + + -- Variable: latex-error-regexp + Regular expression of error message (`"l\\.[1-9][0-9]*"') + + -- Variable: latex-dos-emergency-message + Message latex command running on DOS puts at abort (`"Emergency + stop"') + + -- Variable: YaTeX-item-regexp + Regular expression of item command (`"\\\\item"') + + -- Variable: YaTeX-verb-regexp + Regexp of verb family. Omit \\\\. (`"verb\\*?\\|path"') + + -- Variable: YaTeX-nervous + T for using local dictionary (`t') + + -- Variable: YaTeX-sectioning-regexp + Regexp of LaTeX sectioning command + (`"\\(part\\|chapter\\*?\\|\\(sub\\)*\\(section\\|paragraph\\)\\*?\\)\\b"') + + -- Variable: YaTeX-fill-inhibit-environments + Inhibit fill in these environments (`'("tabular" "tabular*" "array" + "picture" "eqnarray" "eqnarray*" "equation" "math" "displaymath" + "verbatim" "verbatim*")') + + -- Variable: YaTeX-uncomment-once + T for deleting all preceding `%' (`nil') + + -- Variable: YaTeX-close-paren-always + T for always close all parenthesis automatically, `nil' for only eol + (`t') + + -- Variable: YaTeX-auto-math-mode + Switch math-mode automatically (`t') + + -- Variable: YaTeX-math-key-list-private + User defined alist, math-mode-prefix vs completion alist used in + image completion (`nil'). See `yatexmth.el' for the information + about how to define a completion alist. + + -- Variable: YaTeX-default-pop-window-height + Initial height of typesetting buffer when one-window. Number for the + lines of the buffer, numerical string for the percentage of the + screen-height. `nil' for half height (10) + + -- Variable: YaTeX-help-file + Global online help file name + (`$doc-directory/../../site-lisp/YATEXHLP.eng') + + -- Variable: YaTeX-help-file-private + Private online help file name (`"~/YATEXHLP.eng"') + + -- Variable: YaTeX-no-begend-shortcut + Disable [prefix] b ?? shortcut (`nil)' + + -- Variable: YaTeX-hilit-pattern-adjustment-private + List of the list that contain the regular expression and the symbol + of logical meaning of the string that matches the pattern. See also + the value from `(assq 'yatex-mode hilit-patterns-alist)' and the + value of `YaTeX-hilit-pattern-adjustment-default' (and even the + document of hilit19.el). + + -- Variable: YaTeX-sectioning-level + Alist of LaTeX's sectioning command vs its height. + + -- Variable: YaTeX-hierarchy-ignore-heading-regexp + `YaTeX-display-hierarchy' searches for sectioning command first, and + comment line secondary as a file headings. In latter case, ignore lines + that match with regular expression of this variable. Default value of + this variable is RCS header expressions and mode specifying line `-*- xxxx + -*'. + + -- Variable: YaTeX-skip-default-reader + Non-nil for this variable skips the default argument reader of + section-type command when add-in function for it is not defined + (`nil') + + -- Variable: YaTeX-create-file-prefix-g + When typing `prefix g' on the `\include' line, open the target file + even if the file doesn't exist (`nil') + + -- Variable: YaTeX-simple-messages + Simplyfy messages of various completions (`nil') + + -- Variable: YaTeX-hilit-sectioning-face + When hilit19 and yatex19 is active, YaTeX colors the sectioning + commands. This variable specifies the foreground and background + color of `\part' macro. The default value is `'(yellow/dodgerblue + yellow/slateblue)'. The first element of this list is for the screen + when `hilit-background-mode' is `'light', and the second element is + for `'dark'. You should specify both color as `forecolor/backcolor'. + + -- Variable: YaTeX-hilit-sectioning-attenuation-rate + When color mode, this variable specifies how much attenuate the color + density of `\subparagraph' compared with that of `\chapter' (`'(15 + 40)') See also `YaTeX-hilit-sectioning-face'. + + -- Variable: YaTeX-use-AMS-LaTeX + If you use AMS-LaTeX, set to `t' (`nil') + + -- Variable: YaTeX-use-LaTeX2e + If you use LaTeX2e, set to `t' (`t') + + -- Variable: YaTeX-template-file + File name which is automatically inserted at creation + (`~/work/template.tex') + + -- Variable: YaTeX-search-file-from-top-directory + Non-nil means to search input-files from the directory where main + file exists (`t') + + -- Variable: YaTeX-use-font-lock + Use font-lock to fontify buffer or not (`(featurep 'font-lock)' + + -- Variable: YaTeX-use-hilit19 + Use hilit19 to highlight buffer or not (`(featurep 'hilit19)' + + -- Variable: YaTeX-use-italic-bold + YaTeX tries to search italic, bold fontsets or not (`t' if Emacs-20 + or later). This variable is effective only when font-lock is used. + (`(featurep 'hilit19)' + + -- Variable: YaTeX-singlecmd-suffix + Suffix which is always inserted after maketitle-type macros. `"{}"' + is recommended. + + -- Variable: YaTeX-package-alist-private + Alist of LaTeX2e-package name vs. lists of macros in it. Set this + alist properly and YaTeX automatically check the declaratiion of + `usepackage' for corresponding macro, when you input that macro with + completion. If required `usepackage' is not found, YaTeX also + automatically inserts `\usepackage'. Alist is as follows; + '((PackageName1 (completionType ListOfMacro) (completionType + ListOfMacro)) (PackageName2 (completionType ListOfMacro) + (completionType ListOfMacro...))....) completionType is one of `env, + section, maketitle'. Consult the value of + `YaTeX-package-alist-default' as an example. + + -- Variable: YaTeX-tabular-indentation + At indentation by `C-i' in tabular or array environment, YaTeX put + the additional spaces to the normail indentation depth. The number + of additional spaces is the product of YaTeX-tabular-indentation and + the number of column position in tabular. + + -- Variable: YaTeX-noindent-env-regexp + Regexp of environment names that should begin with no indentation. + All verbatime-like environment name should match with. + + -- Variable: YaTeX-ref-default-label-string + Default \\ref time string format. This format is like strftime(3) + but allowed conversion char are as follows; %y -> Last 2 digit of + year, %b -> Month name, %m -> Monthe number(1-12), %d -> Day, %H -> + Hour, %M -> Minute, %S -> Second, %qx -> alphabetical-decimal + conversion of yymmdd. %qX -> alphabetical-decimal conversion of + HHMMSS. Beware defualt label-string should be always unique. So + this format string should have both time part (%H+%M+%S or %qX) and + date part (%y+(%b|%m)+%d or %qx). + + -- Variable: YaTeX-ref-generate-label-function + Function to generate default label string for unnamed \\label{}s. + The function pointed to this value should take two arguments. First + argument is LaTeX macro's name, second is macro's argument. Here is + an example for using this value. + (setq YaTeX-ref-generate-label-function 'my-yatex-generate-label) + (defun my-yatex-generate-label (command value) + (and (string= command "caption") + (re-search-backward "\\\\begin{\\(figure\\|table\\)}" nil t) + (setq command (match-string 1))) + (let ((alist '(("chapter" . "chap") + ("section" . "sec") + ("subsection" . "subsec") + ("figure" . "fig") + ("table" . "tbl")))) + (if (setq command (cdr (assoc command alist))) + (concat command ":" value) + (YaTeX::ref-generate-label nil nil)))) + + + + +File: yatexe, Node: Sample definitions, Next: Hook variables, Prev: All customizable variables, Up: Lisp variables + +Sample definitions +------------------ + + For instance, to change the prefix key stroke to `ESC', and name of the +user dictionary `~/src/emacs/yatexrc', and set `fill-prefix' to single TAB +character, add the following `setq' to `~/.emacs'. + + (setq YaTeX-prefix "\e" + YaTeX-user-completion-table "~/src/emacs/yatexrc" + YaTeX-fill-prefix " ") + + + +File: yatexe, Node: Hook variables, Next: Hook file, Prev: Sample definitions, Up: Lisp variables + +Hook variables +-------------- + + More customizations will be done by the hook-function defined in +hook-variable `yatex-mode-hook'. This is useful to define a shortcut key +sequence to enter some environments other than `document' and `enumerate' +etc. The following statement defines `[prefix] ba' to enter +`\begin{abstract}' ... `=end{abstract}' immediately. + + (setq yatex-mode-hook + '(lambda() (YaTeX-define-begend-key "ba" "abstract"))) + + You should use functions `YaTeX-define-key', or +`YaTeX-define-begend-key' to define all the key sequences of yatex-mode. + + + +File: yatexe, Node: Hook file, Prev: Hook variables, Up: Lisp variables + +Hook file +--------- + + You can stuff all of YaTeX related expressions into a file named +`yatexhks.el' if you have a lot of codes. YaTeX automatically load this +file at the initialization of itself. Using `yatexhks.el' makes +`yatex-mode-load-hook' unnecessary. + + + +File: yatexe, Node: Add-in functions, Next: Add-in generator, Prev: Lisp variables, Up: Customizations + +Add-in functions +================ + + You can easily define a function to input detailed arguments with +completion according to LaTeX environments or commands. + + +What is add-in functions? +------------------------- + + When you input `tabular' environment, don't you think "I want YaTeX to +complete its argument toward my favorite one such as `{|c|c|c|}'..."? +Yes, you can define the function to complete arguments for any environment +and any LaTeX commands. + + +Procedure +--------- + + Here is the procedure to define add-in functions. + 1. Define the function + 2. Put the function into `yatexhks.el' + +* Menu: + +* How the add-in function works:: +* How the function is called:: +* Useful functions for creating add-in:: +* Contribution:: + + + +File: yatexe, Node: How the add-in function works, Next: How the function is called, Prev: Add-in functions, Up: Add-in functions + +How the add-in function works +----------------------------- + +There are three types of add-in. + + 1. Option add-in + 2. argument add-in + 3. enclosing add-in + +"Option add-in" returns the LaTeX's optional parameters such as optional +strings after `\begin{ENV}', optional strings between a section-type +command and its first argument, and optional strings just after type +maketitle-type command. The following illustrates the name of add-in +functions, where underlined strings are generated by add-in functions. + + \begin{table}[ht] (Function name: YaTeX:table) + ~~~~ + \put(100,200){} (Function name: YaTeX:put) + ~~~~~~~~~ + \sum_{i=0}^{n} (Function name: YaTeX:sum) + ~~~~~~~~~~ + + Obviously, the function name is decided by concatenating the prefix +`YaTeX:' and LaTeX command's name. + + Another add-in type is "argument add-in", which completes arguments for +section-type commands. + + \newcommand{\foo}{bar} (Function name: YaTeX::newcommand) + ~~~~ ~~~ + + When the section-type command is inputted, the function named by +concatenating `YaTeX::' and section-type command, is called automatically +with an integer argument which indicates which argument of section-type +command is being read. Thus the add-in should determine the job referring +the value of its argument. + + "enclosing add-in" is for modifying and/or checking the region that will +be enclosed by section-type commands via `[prefix] S'. An enclosing +add-in function will be called with two arguments, beginning of the +enclosed region and end of the region. Suppose you want to enclose the +existing text `(a+b)/c' by `\frac{}'. + + a/c + | | + A B + +You do set-mark-command at point A and then move to point B. Typing +`[prefix] S' and input `frac' enclose the region like this; + + \frac{a/c} + +Normally, the expression `a/c' is translated to `\frac{a}{c}'. An +enclosing add-in is useful for modifying `/' to `}{'. + +* Menu: + +* Defining option-add-in:: +* Defining argument-add-in:: +* Defining enclosing-add-in:: + + + +File: yatexe, Node: Defining option-add-in, Next: Defining argument-add-in, Prev: How the add-in function works, Up: How the add-in function works + +Defining `option add-in' +........................ + + If you want `{|c|c|c|}' for all `tabular' environment, + + (defun YaTeX:tabular () + "{|c|c|c|}") + +is enough. If you want more complicated format, define as below. + + (defun YaTeX:tabular () + "{@{\\vrule width 1pt\\ }|||@{\\ \\vrule width 1pt}}") + +Note that the character `\' must be described as `\\' in Emacs-Lisp. The +next example reads the tabular format from keyboard. + (defun YaTeX:tabular () + (concat "{" (read-string "Rule: ") "}")) + + + +File: yatexe, Node: Defining argument-add-in, Next: Defining enclosing-add-in, Prev: Defining option-add-in, Up: How the add-in function works + +Defining `argument add-in' +.......................... + + This section describes how to define the add-in function for +`\newcommand'. + + The first argument of `\newcommand' begins always with `\'. The second +argument is usually so complex that we can not edit them in the +minibuffer. Here is the created function considering this. + + (defun YaTeX::newcommand (n) ;n is argument position + (cond + ((= n 1) ;1st argument is macro name + (read-string "Command: " "\\")) ;initial input `\' + ((= n 2) "") ;do nothing when reading arg#2 + (t nil))) + + Note that when the `argument add-in' function return `nil', normal +argument reader will be called. + + + +File: yatexe, Node: Defining enclosing-add-in, Prev: Defining argument-add-in, Up: How the add-in function works + +Defining `enclosing add-in' +........................... + + This section describes how to define the add-in function for text +enclosed by `\frac{}'. + + When enclosing the text `5/3' by `\frac{}', you might want to replace +`/' with `}{'. Enclosing function `YaTeX::frac-region' is called with two +arguments, beginning of enclosed text and end of enclosed text. The +function is expected to replace `/' with `}{'. Here is an example +expression. + + (defun YaTeX::frac-region (beg end) + (catch 'done + (while (search-forward "/" end t) + (goto-char (match-beginning 0)) + (if (y-or-n-p "Replace this slash(/) with `}{'") + (throw 'done (replace-match "}{"))) + (goto-char (match-end 0))))) + + + +File: yatexe, Node: How the function is called, Next: Useful functions for creating add-in, Prev: How the add-in function works, Up: Add-in functions + +How the function is called +-------------------------- + + YaTeX calls the add-in functions for specified begin-type, section-type, +and maketitle-type command, if any. `Option add-in' functions for +begin-type are called when `\begin{ENV}' has been inserted, functions for +section-type are called just before input of the first argument, and +functions for maketitle-type is called after maketitle-type command has +been inserted. `Argument add-in' functions are called at each entry of +arguments for section-type commands. + + + +File: yatexe, Node: Useful functions for creating add-in, Next: Contribution, Prev: How the function is called, Up: Add-in functions + +Useful functions for creating add-in +------------------------------------ + + Many add-in functions for typical LaTeX commands are defined in +`yatexadd.el'. Those are also useful as references. Here are the short +descriptions on useful functions, where [F] means function, [A] means +arguments, [D] means description. + +`[F]' + YaTeX:read-position +`[A]' + Character list which can show up in the brackets +`[D]' + Return the location specifier such as `[htb]'. When nothing is + entered, omit [] itself. If the possible characters are "htbp", call + this function as `(YaTeX:read-position "htbp")' + +`[F]' + YaTeX:read-coordinates +`[A]' + Base prompt, X-axis prompt, Y-axis prompt (each optional) +`[D]' + Read the coordinates with the prompt "BasePrompt X-axisPrompt:" for + X-axis, "BasePrompt Y-axisPrompt:" for Y-axis, and return it in the + form of "(X,Y)". The default prompts are `Dimension', `X', `Y' + respectively. + +`[F]' + YaTeX:check-completion-type +`[A]' + One of the symbols: 'begin, 'section, or 'maketitle +`[D]' + Check the current completion type is specified one and cause error + if not. The variable `YaTeX-current-completion-type' holds the symbol + according to the current completion type. + + + +File: yatexe, Node: Contribution, Prev: Useful functions for creating add-in, Up: Add-in functions + +Contribution +------------ + + If you make your own pretty function and you let it be in public, please +send me the function. I'm going to include it in the next release. + + + +File: yatexe, Node: Add-in generator, Prev: Add-in functions, Up: Customizations + +Add-in generator +================ + + First, don't forget to read the section of add-in functions *Note Add-in +functions::. If you easily understand how to define them, there's no need +to read this section. But being not familiar with Emacs-Lisp, when you +don't have clear idea what to do, this section describes how to get YaTeX +make add-in function. + + There are two methods of generation. One is for fully interactive +generator for beginners and another requires little knowledge of +Emacs-Lisp. + + +Generator for beginners +----------------------- + The former generator is called by + `M-x YaTeX-generate' + +strokes. All you have to do is follow the guidances. Defying them may +cases the disaster (I wonder what is it???). So when you make some +mistake, it is recommendable to type `C-g' and start afresh. + + +Simple generator +---------------- + + The latter generator is invoked by the next sequence. `M-x +YaTeX-generate-simple' This generator can make both "option add-in" and +"argument add-in" (*refer the section add-in functions* *Note How the +add-in function works::), whereas `YaTeX-generate' cannot make "argument +addin". + + For example, assume you have the LaTeX command as follows. + + \epsinput[t](250,50){hoge.eps}{plain}{Picture of foo} + (A) (B) (1) (2) (3) + (A)Optional parameter to specify the position + One of t(top), b(bottom), l(left), r(right) + (B)Maximum size of frame + (1)1st argument is filename of EPS file + (2)2nd argument indicates + plain do nothing + frame make frame around image + dframe make double-frame around image + for included EPS file. + (3)Caption for the picture + + Now get start with generation. Typing `M-x YaTeX-generate-simple' +brings the prompt: + (O)ption? (A)rgument? + + +Generating "option add-in" +.......................... + + Since (A), (B) above are optional argument, all we have to do to +complete them is define the option add-in for them. Let's generate the +function to complete (A). + + M-x YaTeX-generate-simple RET + epsinput RET + o + +Typing as above leads the next prompt. + + Read type(1): (S)tring (C)omplete (F)ile ([)option (P)osition co(O)rd. (q)uit + + This asks that "Which type is the completion style of 1st argument?". +Here are the possible completion style. + +`String' + read plain string +`Complete' + read with completion +`File' + read file name +`Option' + read optional string (if string omitted, omit [] too) +`Position' + read positional option (like [htbp]) +`Coord.' + read coordinates +`Quit' + quit from generating + + Since (A) is the optional argument to specify the location of included +EPS file, the completion style is `Position', and the possible characters +are t, b, l, and r. To tell these information to generator, operate as +follows. + + Read type(1).... p + Acceptable characters: tblr RET + + (B) is coordinate. So its completion style is coOrd. We want a prompt +meaning "Maximum size" when completion. + + Read type(2).... o + Prompt for coordinates: Max size RET + + That's all for optional argument. Select quit. + + Read type(3).... q + + Then the generated option add-in function for \epsinput will be shown in +the next window. + + +Generating "argument add-in" +............................ + + Next, create the argument add-in. The arguments for \epsinput are EPS +file name, framing style, and caption string in sequence. + + M-x YaTeX-generate-simple RET + epsinput RET + a + + Above key strokes bring the prompt that asks the number of argument. +Answer it with 3. + + How many arguments?: 3 RET + + Then the generator asks the completion style and prompt for completion. +Answer them. `f' for FileName and prompt string. + + Read type(1).... f + Prompt for argument#1 EPS file name RET + + The second argument is one of selected symbol. So the completion type +is `Completion'. + + Read type(2).... c + Prompt for argument#2 Include style RET + + Then all the candidates ready to be read. Type single RET after +entering all. + + Item[1](RET to exit): plain RET + Item[2](RET to exit): frame RET + Item[3](RET to exit): dframe RET + Item[4](RET to exit): RET + + The following prompt asks whether the entered string must belong to +candidates or not. In this case, since the argument must be one of +`plain', `frame', and `dframe', type `y'. + + Require match? (y or n) y + + The last argument is the caption string for which any completion is +needed. + + Read type(3).... s + Prompt for argument#3 Caption RET + default: Figure of RET + + Finally we'll get the argument add-in in the next window. + + +Contribution +------------ + + If you get your own pretty function and you let it be in public, please +steel yourself in the happy atmosphere and do not send me the function. I +do know it is not fine because it is generated by yatexgen:-p. + + + +File: yatexe, Node: Etcetera, Next: Copying, Prev: Customizations, Up: Top + +Etcetera +******** + + The standard completion tables provided in `yatex.el' contain a few +LaTeX commands I frequently use. This is to lessen the key strokes to +complete entire word, because too many candidates rarely used often cause +too many hits. Therefore always try to use completion in order to enrich +your dictionary, and you will also find `Wild Bird' growing suitable for +your LaTeX style. + + The package name `Wild Bird' is the English translation of Japanese +title `Yachou', which is a trick on words of Japanese. + + + +File: yatexe, Node: Copying, Prev: Etcetera, Up: Top + +Copying +******* + + This program is distributed as a free software. You can +use/copy/modify/redistribute this software freely but with NO warranty to +anything as a result of using this software. Adopting code from this +program is also free. But I would not do contract act. + +Any reports and suggestions are welcome as long as I feel interests in +this software. My possible e-mail address is `yuuji@yatex.org'. (as of +Jan.2004) And there is mailing list for YaTeX. Although the common +language is Japanese, questions in English will be welcome. To join the +ML, send the mail whose subject is `append' to the address +`yatex@yatex.org. If you have some question, please ask to +`yatex-admin@yatex.org'. + + The specification of this software will be surely modified (depending on +my feelings) without notice :-p. + + + HIROSE Yuuji + +Tag table: +Node: Top149 +Node: What is YaTeX?1490 +Node: Main features1863 +Node: Installation3392 +Node: Typesetting4169 +Node: Calling typesetter5299 +Node: Calling previewer7503 +Node: Printing out7864 +Node: %#notation8156 +Node: Changing typesetter8574 +Node: Splitting input files8938 +Node: Static region for typesetting10363 +Node: Lpr format11492 +Node: Controlling which command to invoke12565 +Node: Editing %# notation13158 +Node: Completion13702 +Node: Begin-type completion14262 +Node: Section-type completion17305 +Node: view-sectioning19740 +Node: Large-type completion21320 +Node: Maketitle-type completion22051 +Node: Arbitrary completion22603 +Node: End completion22993 +Node: Accent completion23463 +Node: Image completion24080 +Node: Greek letters completion26337 +Node: Local dictionaries27064 +Node: Commenting out28001 +Node: Cursor jump29460 +Node: Jump to corresponding object29772 +Node: Invoking image processor31173 +Node: Jump to main file32516 +Node: Jumping around the environment32881 +Node: Jumping to last completion position33299 +Node: Changing and Deleting33808 +Node: Changing LaTeX commands34200 +Node: Killing LaTeX commands35377 +Node: Filling36562 +Node: Updation of includeonly38413 +Node: What column39210 +Node: Intelligent newline40295 +Node: Usepackage checker41949 +Node: Online help42540 +Node: Browsing file hierarchy44215 +Node: Cooperation with other packages45952 +Node: Customizations46657 +Node: Lisp variables46991 +Node: All customizable variables47995 +Node: Sample definitions57794 +Node: Hook variables58307 +Node: Hook file59011 +Node: Add-in functions59350 +Node: How the add-in function works60210 +Node: Defining option-add-in62409 +Node: Defining argument-add-in63131 +Node: Defining enclosing-add-in64013 +Node: How the function is called64867 +Node: Useful functions for creating add-in65543 +Node: Contribution66948 +Node: Add-in generator67222 +Node: Etcetera72594 +Node: Copying73199 + +End tag table diff --git a/docs/yatexe.tex b/docs/yatexe.tex index 371a2f7..ac9d9e5 100644 --- a/docs/yatexe.tex +++ b/docs/yatexe.tex @@ -5,7 +5,7 @@ @iftex @c @syncodeindex fn cp -@c Last modified Sun Apr 15 22:51:34 2012 on firestorm +@c Last modified Thu May 10 11:12:44 2012 on firestorm @syncodeindex vr cp @end iftex @@ -15,7 +15,7 @@ @subtitle Yet Another tex-mode for emacs @title Wild Bird @subtitle // YaTeX // -@author @copyright{} 1991-2003 by HIROSE, Yuuji [yuuji@@yatex.org] +@author @copyright{} 1991-2012 by HIROSE, Yuuji [yuuji@@yatex.org] @end titlepage @node Top, What is YaTeX?, (dir), (dir) diff --git a/docs/yatexj b/docs/yatexj index f275797..1507207 100644 --- a/docs/yatexj +++ b/docs/yatexj Binary files differ diff --git a/docs/yatexj.tex b/docs/yatexj.tex index 64b8067..03d7bfc 100644 --- a/docs/yatexj.tex +++ b/docs/yatexj.tex Binary files differ diff --git a/makefile b/makefile index 05e8962..8d04cae 100644 --- a/makefile +++ b/makefile @@ -49,7 +49,7 @@ # make clean to delete all producted files # make ci to check in all # make co to check out all -MVER = 1.75 +MVER = 1.76 LISP = ${LISP18} ${LISP19} YAHTML = yahtml.el COMMON = yatexlib.el yatexprc.el diff --git a/yahtml.el b/yahtml.el index 53ab59f..151ba30 100644 --- a/yahtml.el +++ b/yahtml.el @@ -1,9 +1,9 @@ ;;; -*- Emacs-Lisp -*- ;;; (c) 1994-2012 by HIROSE Yuuji [yuuji(@)yatex.org] -;;; Last modified Thu Feb 9 08:36:16 2012 on firestorm +;;; Last modified Thu May 10 11:06:39 2012 on firestorm ;;; $Id$ -(defconst yahtml-revision-number "1.75" +(defconst yahtml-revision-number "1.76" "Revision number of running yahtml.el") ;;;[Installation] diff --git a/yatex.el b/yatex.el index 20d216d..71179b1 100644 --- a/yatex.el +++ b/yatex.el @@ -1,15 +1,15 @@ ;;; -*- Emacs-Lisp -*- ;;; Yet Another tex-mode for emacs - //�쒹// -;;; yatex.el rev. 1.75.3 +;;; yatex.el rev. 1.76 ;;; (c)1991-2012 by HIROSE Yuuji.[yuuji@yatex.org] -;;; Last modified Thu Feb 9 09:52:41 2012 on firestorm +;;; Last modified Thu May 10 11:06:33 2012 on firestorm ;;; $Id$ ;;; The latest version of this software is always available at; ;;; http://www.yatex.org/ (require 'comment) (require 'yatexlib) -(defconst YaTeX-revision-number "1.75.3" +(defconst YaTeX-revision-number "1.76" "Revision number of running yatex.el") ;---------- Local variables ----------
-
- Completion for elements that do not have end tags and require only
- attributes. Possible completions are, 
' -> invoke viewer
- * `' -> move cursor to linked target
- * `