diff options
author | Eli Zaretskii <eliz@gnu.org> | 2021-07-04 14:55:42 +0300 |
---|---|---|
committer | Eli Zaretskii <eliz@gnu.org> | 2021-07-04 14:55:42 +0300 |
commit | 31ed5a8c12b23011d23ccaec2b7a8d532013c83e (patch) | |
tree | c074a7405f8a26d7f1893bb224aaf6e6dcc5f764 /doc/misc | |
parent | 28fcdb521922db56a30f75f7d3e656fcb8ef6bd7 (diff) | |
download | emacs-31ed5a8c12b23011d23ccaec2b7a8d532013c83e.tar.gz emacs-31ed5a8c12b23011d23ccaec2b7a8d532013c83e.tar.bz2 emacs-31ed5a8c12b23011d23ccaec2b7a8d532013c83e.zip |
Avoid deprecation warnings with Texinfo 6.8
* doc/lispref/functions.texi (Function Safety):
* doc/misc/srecode.texi (Parts of SRecode):
* doc/misc/wisent.texi (Wisent Semantic, Wisent Lex):
* doc/misc/pcl-cvs.texi (Editing files):
* doc/misc/bovine.texi (top, Starting Rules)
(Bovine Grammar Rules, How Lexical Tokens Match)
(Optional Lambda Expression):
* doc/emacs/msdos.texi (Windows Keyboard):
* doc/emacs/buffers.texi (Several Buffers):
* doc/emacs/text.texi (Text): Avoid using @inforef, which is
deprecated.
Diffstat (limited to 'doc/misc')
-rw-r--r-- | doc/misc/bovine.texi | 25 | ||||
-rw-r--r-- | doc/misc/pcl-cvs.texi | 2 | ||||
-rw-r--r-- | doc/misc/srecode.texi | 2 | ||||
-rw-r--r-- | doc/misc/wisent.texi | 6 |
4 files changed, 19 insertions, 16 deletions
diff --git a/doc/misc/bovine.texi b/doc/misc/bovine.texi index 780f0addb59..9bfb117d1a5 100644 --- a/doc/misc/bovine.texi +++ b/doc/misc/bovine.texi @@ -78,13 +78,13 @@ The @dfn{bovine} parser is the original @semantic{} parser, and is an implementation of an @acronym{LL} parser. It is good for simple languages. It has many conveniences making grammar writing easy. The conveniences make it less powerful than a Bison-like @acronym{LALR} -parser. For more information, @inforef{Top, The Wisent Parser Manual, +parser. For more information, @pxref{Top,, Wisent Parser Development, wisent}. Bovine @acronym{LL} grammars are stored in files with a @file{.by} extension. When compiled, the contents is converted into a file of the form @file{NAME-by.el}. This, in turn is byte compiled. -@inforef{top, Grammar Framework Manual, grammar-fw}. +@xref{top,, Grammar Framework Manual, grammar-fw}. @ifnottex @insertcopying @@ -105,7 +105,8 @@ the form @file{NAME-by.el}. This, in turn is byte compiled. In Bison, one and only one nonterminal is designated as the ``start'' symbol. In @semantic{}, one or more nonterminals can be designated as the ``start'' symbol. They are declared following the @code{%start} -keyword separated by spaces. @inforef{start Decl, ,grammar-fw}. +keyword separated by spaces. @xref{start Decl,, Grammar Framework +Manual, grammar-fw}. If no @code{%start} keyword is used in a grammar, then the very first is used. Internally the first start nonterminal is targeted by the @@ -115,7 +116,8 @@ parser harness. To find locally defined variables, the local context handler needs to parse the body of functional code. The @code{scopestart} declaration specifies the name of a nonterminal used as the goal to parse a local -context, @inforef{scopestart Decl, ,grammar-fw}. Internally the +context, @pxref{scopestart Decl,, Grammar Framework Manual, +grammar-fw}. Internally the scopestart nonterminal is targeted by the reserved symbol @code{bovine-inner-scope}, so it can be found by the parser harness. @@ -124,7 +126,7 @@ scopestart nonterminal is targeted by the reserved symbol The rules are what allow the compiler to create tags from a language file. Once the setup is done in the prologue, you can start writing -rules. @inforef{Grammar Rules, ,grammar-fw}. +rules. @xref{Grammar Rules,, Grammar Framework Manual, grammar-fw}. @example @var{result} : @var{components1} @var{optional-semantic-action1}) @@ -146,8 +148,8 @@ A particular @var{result} written into your grammar becomes the parser's goal. It is designated by a @code{%start} statement (@pxref{Starting Rules}). The value returned by the associated @var{optional-semantic-action} is the parser's result. It should be -a tree of @semantic{} @dfn{tags}, @inforef{Semantic Tags, , -semantic-appdev}. +a tree of @semantic{} @dfn{tags}, @pxref{Semantic Tags,, Semantic +Application Development, semantic-appdev}. @var{components} is made up of symbols. A symbol such as @code{FOO} means that a syntactic token of class @code{FOO} must be matched. @@ -170,8 +172,9 @@ For instance: @end example Means that @code{FOO} is a reserved language keyword, matched as such -by looking up into a keyword table, @inforef{keyword Decl, -,grammar-fw}. This is because @code{"foo"} will be converted to +by looking up into a keyword table, @pxref{keyword Decl,, Grammar +Framework Manual, grammar-fw}. This is because @code{"foo"} will be +converted to @code{FOO} in the lexical analysis stage. Thus the symbol @code{FOO} won't be available any other way. @@ -383,8 +386,8 @@ Is an optional set of labeled values such as @code{:constant-flag t :parent Create a tag with @var{name} of respectively the class @code{variable}, @code{function}, @code{type}, @code{include}, @code{package}, and @code{code}. -See @inforef{Creating Tags, , semantic-appdev} for the lisp -functions these translate into. +See @ref{Creating Tags,, Semantic Application Development, +semantic-appdev}, for the lisp functions these translate into. @end table If the symbol @code{%quotemode backquote} is specified, then use diff --git a/doc/misc/pcl-cvs.texi b/doc/misc/pcl-cvs.texi index 0d4f9769115..4ba067fd81f 100644 --- a/doc/misc/pcl-cvs.texi +++ b/doc/misc/pcl-cvs.texi @@ -839,7 +839,7 @@ files. @item f Find the file that the cursor points to (@code{cvs-mode-find-file}). If the cursor points to a directory, run @code{dired} on that directory; -@inforef{Dired, , emacs}. +@pxref{Dired, Emacs Manual, , emacs}. @item o Like @kbd{f}, but use another window diff --git a/doc/misc/srecode.texi b/doc/misc/srecode.texi index a0e999b6812..1f7473c151a 100644 --- a/doc/misc/srecode.texi +++ b/doc/misc/srecode.texi @@ -259,7 +259,7 @@ contexts to have the same name. Some standard contexts are @code{file}, @code{declaration}, and @code{classdecl}. A context can be automatically derived as well based on the parsing -state from @i{Semantic}. @inforef{Top, Semantic Manual, semantic}. +state from @i{Semantic}. @xref{Top, Semantic Manual,, semantic}. @section Applications Commands that do a particular user task which involves also writing diff --git a/doc/misc/wisent.texi b/doc/misc/wisent.texi index dc5b8e4d205..c0bb7b10a46 100644 --- a/doc/misc/wisent.texi +++ b/doc/misc/wisent.texi @@ -1575,7 +1575,7 @@ To use the Wisent parser with @semantic{} you have to define your grammar in @dfn{WY} form, a grammar format very close to the one used by Bison. -Please @inforef{top, Semantic Grammar Framework Manual, grammar-fw} +Please see @ref{top, Semantic Grammar Framework Manual,, grammar-fw}, for more information on @semantic{} grammars. @menu @@ -1962,8 +1962,8 @@ See implementation of the function @code{wisent-skip-token} in @findex semantic-lex The lexical analysis step of @semantic{} is performed by the general -function @code{semantic-lex}. For more information, @inforef{Writing -Lexers, ,semantic-langdev}. +function @code{semantic-lex}. For more information, see @ref{Writing +Lexers, Semantic Language Development,,semantic-langdev}. @code{semantic-lex} produces lexical tokens of the form: |