#, fuzzy msgid "" msgstr "" "Project-Id-Version: man-pages-l10n VERSION\n" "POT-Creation-Date: 2014-07-17 17:57+0900\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: man-pages-posix/man1p/m4.1p:2 #, no-wrap msgid "M4" msgstr "" #. type: TH #: man-pages-posix/man1p/m4.1p:2 #, no-wrap msgid "2013" msgstr "" #. type: TH #: man-pages-posix/man1p/m4.1p:2 #, no-wrap msgid "IEEE/The Open Group" msgstr "" #. type: TH #: man-pages-posix/man1p/m4.1p:2 #, no-wrap msgid "POSIX Programmer's Manual" msgstr "" #. type: SH #: man-pages-posix/man1p/m4.1p:3 #, no-wrap msgid "PROLOG" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:8 msgid "" "This manual page is part of the POSIX Programmer's Manual. The Linux " "implementation of this interface may differ (consult the corresponding Linux " "manual page for details of Linux behavior), or the interface may not be " "implemented on Linux." msgstr "" #. type: SH #: man-pages-posix/man1p/m4.1p:9 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:11 msgid "m4 \\(em macro processor" msgstr "" #. type: SH #: man-pages-posix/man1p/m4.1p:11 #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:15 #, no-wrap msgid "" "m4 B<[>\\(misB<] [>\\(miD IB<[>=IB<]]>...B< [>\\(miU IB<]>.." ". I...\n" msgstr "" #. type: SH #: man-pages-posix/man1p/m4.1p:16 #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:22 msgid "" "The I utility is a macro processor that shall read one or more text " "files, process them according to their included macro statements, and write " "the results to standard output." msgstr "" #. type: SH #: man-pages-posix/man1p/m4.1p:22 #, no-wrap msgid "OPTIONS" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:33 msgid "" "The I utility shall conform to the Base Definitions volume of POSIX." "1\\(hy2008, I
, I, except that the " "order of the B<\\(miD> and B<\\(miU> options shall be significant, and " "options can be interspersed with operands." msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:35 msgid "The following options shall be supported:" msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:35 #, no-wrap msgid "B<\\(mis>" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:41 msgid "" "Enable line synchronization output for the I preprocessor phase (that " "is, B<#line> directives)." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:41 #, no-wrap msgid "B<\\(miD\\ >IB<[>=IB<]>" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:50 msgid "Define I to I or to null if =I is omitted." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:50 #, no-wrap msgid "B<\\(miU\\ >I" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:53 msgid "Undefine I." msgstr "" #. type: SH #: man-pages-posix/man1p/m4.1p:53 #, no-wrap msgid "OPERANDS" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:55 msgid "The following operand shall be supported:" msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:55 #, no-wrap msgid "I" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:61 msgid "" "A pathname of a text file to be processed. If no I is given, or if it " "is B<'\\(mi'>, the standard input shall be read." msgstr "" #. type: SH #: man-pages-posix/man1p/m4.1p:61 #, no-wrap msgid "STDIN" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:66 msgid "" "The standard input shall be a text file that is used if no I operand " "is given, or if it is B<'\\(mi'>." msgstr "" #. type: SH #: man-pages-posix/man1p/m4.1p:66 #, no-wrap msgid "INPUT FILES" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:70 msgid "The input file named by the I operand shall be a text file." msgstr "" #. type: SH #: man-pages-posix/man1p/m4.1p:70 #, no-wrap msgid "ENVIRONMENT VARIABLES" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:73 msgid "" "The following environment variables shall affect the execution of I:" msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:73 #, no-wrap msgid "I" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:79 msgid "" "Provide a default value for the internationalization variables that are " "unset or null. (See the Base Definitions volume of POSIX.1\\(hy2008, " "I
, I for the precedence of " "internationalization variables used to determine the values of locale " "categories.)" msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:79 #, no-wrap msgid "I" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:82 msgid "" "If set to a non-empty string value, override the values of all the other " "internationalization variables." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:82 #, no-wrap msgid "I" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:86 msgid "" "Determine the locale for the interpretation of sequences of bytes of text " "data as characters (for example, single-byte as opposed to multi-byte " "characters in arguments and input files)." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:86 #, no-wrap msgid "I" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:90 msgid "" "Determine the locale that should be used to affect the format and contents " "of diagnostic messages written to standard error." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:90 #, no-wrap msgid "I" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:93 msgid "" "Determine the location of message catalogs for the processing of " "I." msgstr "" #. type: SH #: man-pages-posix/man1p/m4.1p:93 #, no-wrap msgid "ASYNCHRONOUS EVENTS" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:95 man-pages-posix/man1p/m4.1p:610 msgid "Default." msgstr "" #. type: SH #: man-pages-posix/man1p/m4.1p:95 #, no-wrap msgid "STDOUT" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:98 msgid "" "The standard output shall be the same as the input files, after being " "processed for macro expansion." msgstr "" #. type: SH #: man-pages-posix/man1p/m4.1p:98 #, no-wrap msgid "STDERR" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:106 msgid "" "The standard error shall be used to display strings with the B " "macro, macro tracing enabled by the B macro, the defined text for " "macros written by the B macro, or for diagnostic messages." msgstr "" #. type: SH #: man-pages-posix/man1p/m4.1p:106 #, no-wrap msgid "OUTPUT FILES" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:108 man-pages-posix/man1p/m4.1p:819 msgid "None." msgstr "" #. type: SH #: man-pages-posix/man1p/m4.1p:108 #, no-wrap msgid "EXTENDED DESCRIPTION" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:118 msgid "" "The I utility shall compare each token from the input against the set of " "built-in and user-defined macros. If the token matches the name of a macro, " "then the token shall be replaced by the macro's defining text, if any, and " "rescanned for matching macro names. Once no portion of the token matches the " "name of a macro, it shall be written to standard output. Macros may have " "arguments, in which case the arguments shall be substituted into the " "defining text before it is rescanned." msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:120 msgid "Macro calls have the form:" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:125 #, no-wrap msgid "B<\n" ">I(I, I, ..., I)\n" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:132 msgid "" "Macro names shall consist of letters, digits, and underscores, where the " "first character is not a digit. Tokens not of this form shall not be treated " "as macros." msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:139 msgid "" "The application shall ensure that the Eleft-parenthesisE immediately " "follows the name of the macro. If a token matching the name of a macro is " "not followed by a Eleft-parenthesisE, it is handled as a use of that " "macro without arguments." msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:157 msgid "" "If a macro name is followed by a Eleft-parenthesisE, its arguments " "are the EcommaE-separated tokens between the Eleft-" "parenthesisE and the matching Eright-parenthesisE. Unquoted " "white-space characters preceding each argument shall be ignored. All other " "characters, including trailing white-space characters, are retained. " "EcommaE characters enclosed between Eleft-parenthesisE and " "Eright-parenthesisE characters do not delimit arguments." msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:182 msgid "" "Arguments are positionally defined and referenced. The string B<\"$1\"> in " "the defining text shall be replaced by the first argument. Systems shall " "support at least nine arguments; only the first nine can be referenced, " "using the strings B<\"$1\"> to B<\"$9\">, inclusive. The string B<\"$0\"> is " "replaced with the name of the macro. The string B<\"$#\"> is replaced by the " "number of arguments as a string. The string B<\"$*\"> is replaced by a list " "of all of the arguments, separated by EcommaE characters. The string " "B<\"$@\"> is replaced by a list of all of the arguments separated by " "EcommaE characters, and each argument is quoted using the current " "left and right quoting strings. The string B<\"${\"> produces unspecified " "behavior." msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:186 msgid "" "If fewer arguments are supplied than are in the macro definition, the " "omitted arguments are taken to be null. It is not an error if more arguments " "are supplied than are in the macro definition." msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:194 msgid "" "No special meaning is given to any characters enclosed between matching left " "and right quoting strings, but the quoting strings are themselves discarded. " "By default, the left quoting string consists of a grave accent (backquote) " "and the right quoting string consists of an acute accent (single-quote); see " "also the B macro." msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:205 msgid "" "Comments are written but not scanned for matching macro names; by default, " "the begin-comment string consists of the Enumber-signE character and " "the end-comment string consists of a EnewlineE. See also the " "B and B macros." msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:228 msgid "" "The I utility shall make available the following built-in macros. They " "can be redefined, but once this is done the original meaning is lost. Their " "values shall be null unless otherwise stated. In the descriptions below, the " "term I refers to the value of the macro: the second argument " "to the B macro, among other things. Except for the first argument to " "the B macro, all numeric arguments to built-in macros shall be " "interpreted as decimal values. The string values produced as the defining " "text of the B, B, B, B, B, and B " "built-in macros shall be in the form of a decimal-constant as defined in the " "C language." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:228 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:240 msgid "" "The B macro shall set the begin-comment and end-comment strings. " "With no arguments, the comment mechanism shall be disabled. With a single " "non-null argument, that argument shall become the begin-comment and the " "EnewlineE shall become the end-comment string. With two non-null " "arguments, the first argument shall become the begin-comment string and the " "second argument shall become the end-comment string. The behavior is " "unspecified if either argument is provided but null. Systems shall support " "comment strings of at least five characters." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:240 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:250 msgid "" "The B macro shall set the begin-quote and end-quote strings. " "With no arguments, the quote strings shall be set to the default values " "(that is, `\\|'). The behavior is unspecified if there is a single argument " "or either argument is null. With two non-null arguments, the first argument " "shall become the begin-quote string and the second argument shall become the " "end-quote string. Systems shall support quote strings of at least five " "characters." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:250 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:259 msgid "" "The defining text of the B macro shall be its first argument " "decremented by 1. It shall be an error to specify an argument containing any " "non-numeric characters. The behavior is unspecified if B is not " "immediately followed by a Eleft-parenthesisE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:259 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:269 msgid "" "The second argument shall become the defining text of the macro whose name " "is the first argument. It is unspecified whether the B macro deletes " "all prior definitions of the macro named by its first argument or preserves " "all but the current definition of the macro. The behavior is unspecified if " "B is not immediately followed by a Eleft-parenthesisE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:269 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:277 msgid "" "The defining text of the B macro shall be the quoted definition (using " "the current quoting strings) of its arguments. The behavior is unspecified " "if B is not immediately followed by a Eleft-parenthesisE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:277 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:291 msgid "" "The I utility maintains nine temporary buffers, numbered 1 to 9, " "inclusive. When the last of the input has been processed, any output that " "has been placed in these buffers shall be written to standard output in " "buffer-numerical order. The B macro shall divert future output to " "the buffer specified by its argument. Specifying no argument or an argument " "of 0 shall resume the normal output process. Output diverted to a stream " "with a negative number shall be discarded. Behavior is implementation-" "defined if a stream number larger than 9 is specified. It shall be an error " "to specify an argument containing any non-numeric characters." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:291 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:295 msgid "" "The defining text of the B macro shall be the number of the current " "output stream as a string." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:295 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:302 msgid "" "The B macro shall cause I to discard all input characters up to and " "including the next EnewlineE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:302 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:308 msgid "" "The B macro shall write the defined text to standard error for each " "of the macros specified as arguments, or, if no arguments are specified, for " "all macros." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:308 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:316 msgid "" "The B macro shall write its arguments to standard error. The " "behavior is unspecified if B is not immediately followed by a " "Eleft-parenthesisE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:316 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:324 msgid "" "The B macro shall evaluate its first argument as an arithmetic " "expression, using signed integer arithmetic with at least 32-bit precision. " "At least the following C-language operators shall be supported, with " "precedence, associativity, and behavior as described in I
, " "I:" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:333 #, no-wrap msgid "B<\n" "()\n" "unary +\n" "unary \\(mi\n" "\\&~>\n" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:353 #, no-wrap msgid "" "\\&!\n" "binary *\n" "/\n" "%\n" "binary +\n" "binary \\(mi\n" "EE\n" "EE\n" "E\n" "E=\n" "E\n" "E=\n" "=\\|=\n" "!=\n" "binary &\n" "\\&^\n" "|\n" "&&\n" "||\n" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:368 msgid "" "Systems shall support octal and hexadecimal numbers as in the ISO\\ C " "standard. The second argument, if specified, shall set the radix for the " "result; if the argument is blank or unspecified, the default is 10. Behavior " "is unspecified if the radix falls outside the range 2 to 36, inclusive. The " "third argument, if specified, sets the minimum number of digits in the " "result. Behavior is unspecified if the third argument is less than zero. It " "shall be an error to specify the second or third argument containing any non-" "numeric characters. The behavior is unspecified if B is not " "immediately followed by a Eleft-parenthesisE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:369 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:378 msgid "" "If the first argument to the B macro is defined, the defining text " "shall be the second argument. Otherwise, the defining text shall be the " "third argument, if specified, or the null string, if not. The behavior is " "unspecified if B is not immediately followed by a Eleft-" "parenthesisE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:378 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:394 msgid "" "The B macro takes three or more arguments. If the first two " "arguments compare as equal strings (after macro expansion of both " "arguments), the defining text shall be the third argument. If the first two " "arguments do not compare as equal strings and there are three arguments, the " "defining text shall be null. If the first two arguments do not compare as " "equal strings and there are four or five arguments, the defining text shall " "be the fourth argument. If the first two arguments do not compare as equal " "strings and there are six or more arguments, the first three arguments shall " "be discarded and processing shall restart with the remaining arguments. The " "behavior is unspecified if B is not immediately followed by a " "Eleft-parenthesisE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:394 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:402 msgid "" "The defining text for the B macro shall be the contents of the file " "named by the first argument. It shall be an error if the file cannot be read." " The behavior is unspecified if B is not immediately followed by a " "Eleft-parenthesisE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:402 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:411 msgid "" "The defining text of the B macro shall be its first argument " "incremented by 1. It shall be an error to specify an argument containing any " "non-numeric characters. The behavior is unspecified if B is not " "immediately followed by a Eleft-parenthesisE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:411 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:421 msgid "" "The defining text of the B macro shall be the first character " "position (as a string) in the first argument where a string matching the " "second argument begins (zero origin), or \\(mi1 if the second argument does " "not occur. The behavior is unspecified if B is not immediately " "followed by a Eleft-parenthesisE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:421 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:429 msgid "" "The defining text of the B macro shall be the length (as a string) of " "the first argument. The behavior is unspecified if B is not " "immediately followed by a Eleft-parenthesisE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:429 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:435 msgid "" "Exit from the I utility. If the first argument is specified, it is the " "exit code. The default is zero. It shall be an error to specify an argument " "containing any non-numeric characters." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:435 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:445 msgid "" "The first argument shall be processed when EOF is reached. If the B " "macro is used multiple times, the arguments specified shall be processed in " "the order in which the B macros were processed. The behavior is " "unspecified if B is not immediately followed by a Eleft-" "parenthesisE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:445 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:453 msgid "" "The defining text shall be the first argument, with any trailing B<'X'> " "characters replaced with the current process ID as a string. The behavior " "is unspecified if B is not immediately followed by a Eleft-" "parenthesisE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:453 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:475 msgid "" "The first argument shall be taken as a template for creating an empty file, " "with trailing B<'X'> characters replaced with characters from the portable " "filename character set. The behavior is unspecified if the first argument " "does not end in at least six B<'X'> characters. If a temporary file is " "successfully created, then the defining text of the macro shall be the name " "of the new file. The user ID of the file shall be set to the effective user " "ID of the process. The group ID of the file shall be set to the group ID of " "the file's parent directory or to the effective group ID of the process. The " "file access permission bits are set such that only the owner can both read " "and write the file, regardless of the current I of the process. If a " "file could not be created, the defining text of the macro shall be the empty " "string. The behavior is unspecified if B is not immediately " "followed by a Eleft-parenthesisE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:475 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:484 msgid "" "The B macro shall delete the current definition of its arguments, " "replacing that definition with the previous one. If there is no previous " "definition, the macro is undefined. The behavior is unspecified if B " "is not immediately followed by a Eleft-parenthesisE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:484 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:496 msgid "" "The B macro shall be equivalent to the B macro with the " "exception that it shall preserve any current definition for future retrieval " "using the B macro. The behavior is unspecified if B is not " "immediately followed by a Eleft-parenthesisE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:496 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:505 msgid "" "The defining text for the B macro shall be a comma-separated list of " "its arguments except the first one. Each argument shall be quoted using the " "current quoting strings. The behavior is unspecified if B is not " "immediately followed by a Eleft-parenthesisE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:505 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:515 msgid "" "The B macro shall be equivalent to the B macro, except " "that it shall not be an error if the file is inaccessible. The behavior is " "unspecified if B is not immediately followed by a Eleft-" "parenthesisE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:515 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:530 msgid "" "The defining text for the B macro shall be the substring of the " "first argument beginning at the zero-offset character position specified by " "the second argument. The third argument, if specified, shall be the number " "of characters to select; if not specified, the characters from the starting " "point to the end of the first argument shall become the defining text. It " "shall not be an error to specify a starting point beyond the end of the " "first argument and the defining text shall be null. It shall be an error to " "specify an argument containing any non-numeric characters. The behavior is " "unspecified if B is not immediately followed by a Eleft-" "parenthesisE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:530 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:545 msgid "" "The B macro shall interpret its first argument as a shell command " "line. The defining text shall be the string result of that command. The " "string result shall not be rescanned for macros while setting the defining " "text. No output redirection shall be performed by the I utility. The " "exit status value from the command can be retrieved using the B " "macro. The behavior is unspecified if B is not immediately followed " "by a Eleft-parenthesisE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:545 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:551 msgid "" "The defining text of the B macro shall be the exit value of the " "utility last invoked by the B macro (as a string)." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:551 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:557 msgid "" "The B macro shall enable tracing for the macros specified as " "arguments, or, if no arguments are specified, for all macros. The trace " "output shall be written to standard error in an unspecified format." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:557 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:562 msgid "" "The B macro shall disable tracing for the macros specified as " "arguments, or, if no arguments are specified, for all macros." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:562 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:580 msgid "" "The defining text of the B macro shall be the first argument with " "every character that occurs in the second argument replaced with the " "corresponding character from the third argument. If no replacement character " "is specified for some source character because the second argument is longer " "than the third argument, that character shall be deleted from the first " "argument in B's defining text. The behavior is unspecified if the " "B<'\\(mi'> character appears within the second or third argument anywhere " "besides the first or last character. The behavior is unspecified if the same " "character appears more than once in the second argument. The behavior is " "unspecified if B is not immediately followed by a Eleft-" "parenthesisE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:580 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:589 msgid "" "The B macro shall delete all definitions (including those " "preserved using the B macro) of the macros named by its arguments. " "The behavior is unspecified if B is not immediately followed by a " "Eleft-parenthesisE." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:589 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:598 msgid "" "The B macro shall cause immediate output of any text in temporary " "buffers named as arguments, or all temporary buffers if no arguments are " "specified. Buffers can be undiverted into other temporary buffers. " "Undiverting shall discard the contents of the temporary buffer. The behavior " "is unspecified if an argument contains any non-numeric characters." msgstr "" #. type: SH #: man-pages-posix/man1p/m4.1p:598 #, no-wrap msgid "EXIT STATUS" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:600 msgid "The following exit values shall be returned:" msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:600 #, no-wrap msgid "\\00" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:602 msgid "Successful completion." msgstr "" #. type: IP #: man-pages-posix/man1p/m4.1p:602 #, no-wrap msgid "E0" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:604 msgid "An error occurred" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:608 msgid "" "If the B macro is used, the exit value can be specified by the input " "file." msgstr "" #. type: SH #: man-pages-posix/man1p/m4.1p:608 #, no-wrap msgid "CONSEQUENCES OF ERRORS" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:612 msgid "I" msgstr "" #. type: SH #: man-pages-posix/man1p/m4.1p:612 #, no-wrap msgid "APPLICATION USAGE" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:616 msgid "The B macro is useful for renaming macros, especially built-ins." msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:654 msgid "" "Since B defers to the ISO\\ C standard, some operations have undefined " "behavior. In some implementations, division or remainder by zero cause a " "fatal signal, even if the division occurs on the short-circuited branch of " "B<\"&&\"> or B<\"||\">. Any operation that overflows in signed arithmetic " "produces undefined behavior. Likewise, using the B operators with a " "shift amount that is not positive and smaller than the precision is " "undefined, as is shifting a negative number to the right. Historically, not " "all implementations obeyed C-language precedence rules: B<'~'> and B<'!'> " "were lower than B<'=='>; B<'=='> and B<'!='> were not lower than B<'E'>; " "and B<'|'> was not lower than B<'^'>; the liberal use of B<\"()\"> can force " "the desired precedence even with these non-compliant implementations. " "Furthermore, some traditional implementations treated B<'^'> as an " "exponentiation operator, although most implementations now use B<\"**\"> as " "an extension for this purpose." msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:671 msgid "" "When a macro has been multiply defined via the B macro, it is " "unspecified whether the B macro will alter only the most recent " "definition (as though by B and B), or replace the entire " "stack of definitions with a single definition (as though by B and " "B). An application desiring particular behavior for the B " "macro in this case can redefine it accordingly." msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:677 msgid "" "Applications should use the B macro instead of the obsolescent " "B macro for creating temporary files." msgstr "" #. type: SH #: man-pages-posix/man1p/m4.1p:677 #, no-wrap msgid "EXAMPLES" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:681 msgid "If the file B contains the lines:" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:690 #, no-wrap msgid "" "B<\n" "The value of `VER' is \"VER\".\n" "ifdef(`VER', ``VER'' is defined to be VER., VER is not defined.)\n" "ifelse(VER, 1, ``VER'' is `VER'.)\n" "ifelse(VER, 2, ``VER'' is `VER'., ``VER'' is not 2.)\n" "end>\n" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:695 msgid "then the command" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:700 #, no-wrap msgid "B<\n" "m4 m4src>\n" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:705 msgid "or the command:" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:710 #, no-wrap msgid "B<\n" "m4 \\(miU VER m4src>\n" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:715 man-pages-posix/man1p/m4.1p:739 man-pages-posix/man1p/m4.1p:763 man-pages-posix/man1p/m4.1p:787 msgid "produces the output:" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:721 #, no-wrap msgid "B<\n" "The value of VER is \"VER\".\n" "VER is not defined.>\n" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:724 man-pages-posix/man1p/m4.1p:748 #, no-wrap msgid "VER is not 2.\n" "end\n" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:729 man-pages-posix/man1p/m4.1p:753 man-pages-posix/man1p/m4.1p:777 msgid "The command:" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:734 #, no-wrap msgid "B<\n" "m4 \\(miD VER m4src>\n" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:745 #, no-wrap msgid "B<\n" "The value of VER is \"\".\n" "VER is defined to be .>\n" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:758 #, no-wrap msgid "B<\n" "m4 \\(miD VER=1 m4src>\n" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:772 #, no-wrap msgid "" "B<\n" "The value of VER is \"1\".\n" "VER is defined to be 1.\n" "VER is 1.\n" "VER is not 2.\n" "end>\n" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:782 #, no-wrap msgid "B<\n" "m4 \\(miD VER=2 m4src>\n" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:793 #, no-wrap msgid "B<\n" "The value of VER is \"2\".\n" "VER is defined to be 2.>\n" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:796 #, no-wrap msgid "VER is 2.\n" "end\n" msgstr "" #. type: SH #: man-pages-posix/man1p/m4.1p:799 #, no-wrap msgid "RATIONALE" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:810 msgid "" "Historic System V-based behavior treated B<\"${\"> in a macro definition as " "two literal characters. However, this sequence is left unspecified so that " "implementations may offer extensions such as B<\"${11}\"> meaning the " "eleventh positional parameter. Macros can still be defined with appropriate " "uses of nested quoting to result in a literal B<\"${\"> in the output after " "rescanning removes the nested quotes." msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:817 msgid "" "In the B built-in, historic System V-based behavior treated " "B<'\\(mi'> as a literal; GNU behavior treats it as a range. This version of " "the standard allows either behavior." msgstr "" #. type: SH #: man-pages-posix/man1p/m4.1p:817 #, no-wrap msgid "FUTURE DIRECTIONS" msgstr "" #. type: SH #: man-pages-posix/man1p/m4.1p:819 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:821 msgid "I\\^" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:825 msgid "" "The Base Definitions volume of POSIX.1\\(hy2008, I, I, I
, I" msgstr "" #. type: SH #: man-pages-posix/man1p/m4.1p:825 #, no-wrap msgid "COPYRIGHT" msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:836 msgid "" "Portions of this text are reprinted and reproduced in electronic form from " "IEEE Std 1003.1, 2013 Edition, Standard for Information Technology -- " "Portable Operating System Interface (POSIX), The Open Group Base " "Specifications Issue 7, Copyright (C) 2013 by the Institute of Electrical " "and Electronics Engineers, Inc and The Open Group. (This is POSIX.1-2008 " "with the 2013 Technical Corrigendum 1 applied.) In the event of any " "discrepancy between this version and the original IEEE and The Open Group " "Standard, the original IEEE and The Open Group Standard is the referee " "document. The original Standard can be obtained online at http://www.unix." "org/online.html ." msgstr "" #. type: Plain text #: man-pages-posix/man1p/m4.1p:841 msgid "" "Any typographical or formatting errors that appear in this page are most " "likely to have been introduced during the conversion of the source files to " "man page format. To report such errors, see https://www.kernel.org/doc/man-" "pages/reporting_bugs.html ." msgstr ""