Mercurial > gnulib
view doc/quote.texi @ 40198:5a34193cbc07
long-options: add parse_gnu_standard_options_only
Discussed in https://bugs.gnu.org/33468 .
* lib/long-options.c (parse_long_options): Use EXIT_SUCCESS instead
of 0.
(parse_gnu_standard_options_only): Add function to
process the GNU default options --help and --version and fail for any other
unknown long or short option. See
https://gnu.org/prep/standards/html_node/Command_002dLine-Interfaces.html .
* lib/long-options.h (parse_gnu_standard_options_only): Declare it.
* modules/long-options (depends-on): Add stdbool, exitfail.
* top/maint.mk (sc_prohibit_long_options_without_use): Update
syntax-check rule, add new function name.
author | Bernhard Voelker <mail@bernhard-voelker.de> |
---|---|
date | Thu, 29 Nov 2018 09:06:26 +0100 |
parents | b06060465f09 |
children |
line wrap: on
line source
@node Quoting @section Quoting @c Copyright (C) 2005, 2009-2019 Free Software Foundation, Inc. @c Permission is granted to copy, distribute and/or modify this document @c under the terms of the GNU Free Documentation License, Version 1.3 or @c any later version published by the Free Software Foundation; with no @c Invariant Sections, no Front-Cover Texts, and no Back-Cover @c Texts. A copy of the license is included in the ``GNU Free @c Documentation License'' file as part of this distribution. @cindex Quoting @findex quote @findex quotearg Gnulib provides @samp{quote} and @samp{quotearg} modules to help with quoting text, such as file names, in messages to the user. Here's an example of using @samp{quote}: @example #include <quote.h> ... error (0, errno, _("cannot change owner of %s"), quote (fname)); @end example This differs from @example error (0, errno, _("cannot change owner of '%s'"), fname); @end example @noindent in that @code{quote} escapes unusual characters in @code{fname}, e.g., @samp{'} and control characters like @samp{\n}. @findex quote_n However, a caveat: @code{quote} reuses the storage that it returns. Hence if you need more than one thing quoted at the same time, you need to use @code{quote_n}. @findex quotearg_alloc Also, the @code{quote} module is not suited for multithreaded applications. In that case, you have to use @code{quotearg_alloc}, defined in the @samp{quotearg} module, which is decidedly less convenient.