LINUX.ORG.RU

История изменений

Исправление Shushundr, (текущая версия) :

warning: environment command format as argument to @alias

В формате texinfo @команды могут быть однострочными и обрамляющими блок текста при помощи двух вызовов @команда @end команда. Если создаётся алиас для команд второго вида, то выдаётся такой варнинг.

https://www.gnu.org/software/texinfo/manual/texinfo/html_node/_0040format.html

«The @format command is similar to @display, except it leaves the text unindented.»

https://www.gnu.org/software/texinfo/manual/texinfo/html_node/_0040display.html

«The @display command begins another kind of environment, where the font is left unchanged, not switched to typewriter as with @example. … The @display command indents the text, but does not fill it.»

$ head libavl.hdr -n 89 | tail -n 5
@macro cr
@end macro
@alias begincode = format
@alias endcode = end
@macro blankline

https://www.gnu.org/software/texinfo/manual/texinfo/html_node/_0040alias.html

«Unfortunately, it’s not possible to alias Texinfo environments; for example, @alias lang=example is an error.»

Я не знаю, что такое «Texinfo environment» (потому что в документации нет гиперссылки на определение термина), но вот выше в документации про @display как раз упоминалось @example и в описании были слова «another kind of environment».

Ну и что теперь делать? Искать в .w-файле пары @begincode/@endcode и заменять на @format/@end format ? Так потеряется «семантика», для сохранения которой, вроде как была создана команда @alias… Мне, кстати, непонятно, что будет плохого, если эта семантика потеряется. В документации про такое не пишут.

В самом .w-файле такого нет, это добавляет утилита texiweb:

$ grep -n  begincode *.c
texiweb.c:1649:      "@alias begincode = format\n",
texiweb.c:1695:      "@macro begincode\n",
texiweb.c:2952:      emits ("@begincode\n");

И ещё такой кусок текста есть:

      "@macro begincode\n",
      /* Uncomment to put a thin rule above code segments. */
      /* "@vskip 1pt plus0pt@hrule@vskip -2pt plus0pt", */
      "@smallskip\n",
      "@end macro\n",
      "@macro endcode {ignore}\n",
      /* Uncomment to put a thin rule below code segments. */
      /* "@vskip 1pt plus0pt@hrule\n", */
      "@end macro\n",

Само макро используется в файле intro.w:

ChangeLog-2004-12-28  Ben Pfaff  <blp@gnu.org>
ChangeLog-
ChangeLog-	* texiweb.c: Support recent Texinfo.
ChangeLog:	(open_header_file) Change strategy used for @begincode, @endcode
ChangeLog-	in output.
ChangeLog-	(transition) Ditto.
ChangeLog-

$ grep -n "begincode" *
intro.w:129:@begincode
intro.w:183:@begincode
intro.w:217:@begincode

Исправление Shushundr, :

warning: environment command format as argument to @alias

В формате texinfo @команды могут быть однострочными и обрамляющими блок текста при помощи двух вызовов @команда @end команда. Если создаётся алиас для команд второго вида, то выдаётся такой варнинг.

https://www.gnu.org/software/texinfo/manual/texinfo/html_node/_0040format.html

«The @format command is similar to @display, except it leaves the text unindented.»

https://www.gnu.org/software/texinfo/manual/texinfo/html_node/_0040display.html

«The @display command begins another kind of environment, where the font is left unchanged, not switched to typewriter as with @example. … The @display command indents the text, but does not fill it.»

$ head libavl.hdr -n 89 | tail -n 5
@macro cr
@end macro
@alias begincode = format
@alias endcode = end
@macro blankline

https://www.gnu.org/software/texinfo/manual/texinfo/html_node/_0040alias.html

«Unfortunately, it’s not possible to alias Texinfo environments; for example, @alias lang=example is an error.»

Я не знаю, что такое «Texinfo environment» (потому что в документации нет гиперссылки на определение термина), но вот выше в документации про @display как раз упоминалось @example и в описании были слова «another kind of environment».

Ну и что теперь делать? Искать в .w-файле пары @begincode/@endcode и заменять на @format/@end format ? Так потеряется «семантика», для сохранения которой, вроде как была создана команда @alias… Мне, кстати, непонятно, что будет плохого, если эта семантика потеряется. В документации про такое не пишут.

В самом .w-файле такого нет, это добавляет утилита texiweb:

$ grep -n  begincode *.c
texiweb.c:1649:      "@alias begincode = format\n",
texiweb.c:1695:      "@macro begincode\n",
texiweb.c:2952:      emits ("@begincode\n");

И ещё такой кусок текста есть:

      "@macro begincode\n",
      /* Uncomment to put a thin rule above code segments. */
      /* "@vskip 1pt plus0pt@hrule@vskip -2pt plus0pt", */
      "@smallskip\n",
      "@end macro\n",
      "@macro endcode {ignore}\n",
      /* Uncomment to put a thin rule below code segments. */
      /* "@vskip 1pt plus0pt@hrule\n", */
      "@end macro\n",

Исправление Shushundr, :

warning: environment command format as argument to @alias

В формате texinfo @команды могут быть однострочными и обрамляющими блок текста при помощи двух вызовов @команда @end команда. Если создаётся алиас для команд второго вида, то выдаётся такой варнинг.

https://www.gnu.org/software/texinfo/manual/texinfo/html_node/_0040format.html

«The @format command is similar to @display, except it leaves the text unindented.»

https://www.gnu.org/software/texinfo/manual/texinfo/html_node/_0040display.html

«The @display command begins another kind of environment, where the font is left unchanged, not switched to typewriter as with @example. … The @display command indents the text, but does not fill it.»

$ head libavl.hdr -n 89 | tail -n 5
@macro cr
@end macro
@alias begincode = format
@alias endcode = end
@macro blankline

https://www.gnu.org/software/texinfo/manual/texinfo/html_node/_0040alias.html

«Unfortunately, it’s not possible to alias Texinfo environments; for example, @alias lang=example is an error.»

Я не знаю, что такое «Texinfo environment» (потому что в документации нет гиперссылки на определение термина), но вот выше в документации про @display как раз упоминалось @example и в описании были слова «another kind of environment».

Ну и что теперь делать? Искать в .w-файле пары @begincode/@endcode и заменять на @format/@end format ? Так потеряется «семантика», для сохранения которой, вроде как была создана команда @alias… Мне, кстати, непонятно, что будет плохого, если эта семантика потеряется. В документации про такое не пишут.

В самом .w-файле такого нет, это добавляет утилита texiweb:

$ grep -n  begincode *.c
texiweb.c:1649:      "@alias begincode = format\n",
texiweb.c:1695:      "@macro begincode\n",
texiweb.c:2952:      emits ("@begincode\n");

Исправление Shushundr, :

warning: environment command format as argument to @alias

В формате texinfo @команды могут быть однострочными и обрамляющими блок текста при помощи двух вызовов @команда @end команда. Если создаётся алиас для команд второго вида, то выдаётся такой варнинг.

https://www.gnu.org/software/texinfo/manual/texinfo/html_node/_0040format.html

«The @format command is similar to @display, except it leaves the text unindented.»

https://www.gnu.org/software/texinfo/manual/texinfo/html_node/_0040display.html

«The @display command begins another kind of environment, where the font is left unchanged, not switched to typewriter as with @example. … The @display command indents the text, but does not fill it.»

$ head libavl.hdr -n 89 | tail -n 5
@macro cr
@end macro
@alias begincode = format
@alias endcode = end
@macro blankline

https://www.gnu.org/software/texinfo/manual/texinfo/html_node/_0040alias.html

«Unfortunately, it’s not possible to alias Texinfo environments; for example, @alias lang=example is an error.»

Я не знаю, что такое «Texinfo environment» (потому что в документации нет гиперссылки на определение термина), но вот выше в документации про @display как раз упоминалось @example и в описании были слова «another kind of environment».

Ну и что теперь делать? Искать в .w-файле пары @begincode/@endcode и заменять на @format/@end format ? Так потеряется «семантика», для сохранения которой, вроде как была создана команда @alias… Мне, кстати, непонятно, что будет плохого, если эта семантика потеряется. В документации про такое не пишут.

Исходная версия Shushundr, :

warning: environment command format as argument to @alias

В формате texinfo @команды могут быть однострочными и обрамляющими блок текста при помощи двух вызовов @команда @end команда. Если создаётся алиас для команд второго вида, то выдаётся такой варнинг.

https://www.gnu.org/software/texinfo/manual/texinfo/html_node/_0040format.html

«The @format command is similar to @display, except it leaves the text unindented.»

https://www.gnu.org/software/texinfo/manual/texinfo/html_node/_0040display.html

«The @display command begins another kind of environment, where the font is left unchanged, not switched to typewriter as with @example. … The @display command indents the text, but does not fill it.»

$ head libavl.hdr -n 89 | tail -n 5
@macro cr
@end macro
@alias begincode = format
@alias endcode = end
@macro blankline

https://www.gnu.org/software/texinfo/manual/texinfo/html_node/_0040alias.html

«Unfortunately, it’s not possible to alias Texinfo environments; for example, @alias lang=example is an error.»

Я не знаю, что такое «Texinfo environment» (потому что в документации нет гиперссылки на определение термина), но вот выше в документации про @display как раз упоминалось @example и в описании были слова «another kind of environment».

Ну и что теперь делать? Искать в .w-файле пары @begincode/@endcode и заменять на @format/@end format ? Так потеряется «семантика», для сохранения которой, вроде как была создана команда @alias… Мне, кстати, непонятно, что будет плохого, если эта семантика потеряется. В документации про такое не пишут.