]> git.ipfire.org Git - thirdparty/cups.git/commitdiff
Update CUPS programming manual to explain what "localization" means.
authorMichael Sweet <michael.r.sweet@gmail.com>
Thu, 29 Jun 2017 18:17:33 +0000 (14:17 -0400)
committerMichael Sweet <michael.r.sweet@gmail.com>
Thu, 29 Jun 2017 18:17:33 +0000 (14:17 -0400)
cups/cupspm.md
doc/help/cupspm.epub
doc/help/cupspm.html

index 452f4b140dcf803c859a4fca1587858c8fee5351..2a247718a495d627fd070c36167de4f9647e79f4 100644 (file)
@@ -609,8 +609,9 @@ Finally, the `cupsGetDestMediaDefault` function returns the default media size:
 
 ### Localizing Options and Values
 
-CUPS provides three functions to get localized versions of options and values:
-`cupsLocalizeDestMedia`, `cupsLocalizeDestOption`, and `cupsLocalizeDestValue`:
+CUPS provides three functions to get localized, human-readable strings in the
+user's current locale for options and values: `cupsLocalizeDestMedia`,
+`cupsLocalizeDestOption`, and `cupsLocalizeDestValue`:
 
     const char *
     cupsLocalizeDestMedia(http_t *http, cups_dest_t *dest,
index 7166a718b50a8530997c5b977b200e6bf1107f4c..981b143804ac202b3693d09a5db5a9926c0cd54d 100644 (file)
Binary files a/doc/help/cupspm.epub and b/doc/help/cupspm.epub differ
index 9585073209d3bdf32fc6985f7acfff08e606baa5..8f572f139b39e2947694fe75ebe85badf9a8ffcd 100644 (file)
@@ -898,7 +898,7 @@ cupsGetDestMediaDefault(http_t *http, cups_dest_t *dest,
                         cups_size_t *size);
 </code></pre>
     <h4><a id="localizing-options-and-values">Localizing Options and Values</a></h4>
-    <p>CUPS provides three functions to get localized versions of options and values: <code>cupsLocalizeDestMedia</code>, <code>cupsLocalizeDestOption</code>, and <code>cupsLocalizeDestValue</code>:</p>
+    <p>CUPS provides three functions to get localized, human-readable strings in the user's current locale for options and values: <code>cupsLocalizeDestMedia</code>, <code>cupsLocalizeDestOption</code>, and <code>cupsLocalizeDestValue</code>:</p>
     <pre><code>const char *
 cupsLocalizeDestMedia(http_t *http, cups_dest_t *dest,
                       cups_dinfo_t *info, unsigned flags,