From 78b1b83be0cf04b4cba707751b7ad4d97787fe37 Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Sat, 27 Nov 2021 21:54:49 -0500 Subject: track document samples used --- .../media/text/pot/project_coding-style.ssi.pot | 430 +++++++++++++++++++++ 1 file changed, 430 insertions(+) create mode 100644 markup/pod/live-manual/media/text/pot/project_coding-style.ssi.pot (limited to 'markup/pod/live-manual/media/text/pot/project_coding-style.ssi.pot') diff --git a/markup/pod/live-manual/media/text/pot/project_coding-style.ssi.pot b/markup/pod/live-manual/media/text/pot/project_coding-style.ssi.pot new file mode 100644 index 0000000..5c076a5 --- /dev/null +++ b/markup/pod/live-manual/media/text/pot/project_coding-style.ssi.pot @@ -0,0 +1,430 @@ +# SOME DESCRIPTIVE TITLE +# Copyright (C) YEAR Free Software Foundation, Inc. +# This file is distributed under the same license as the live-manual package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: live-manual 5.0~a2-1\n" +"POT-Creation-Date: 2015-08-23 11:04+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"Language: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=CHARSET\n" +"Content-Transfer-Encoding: 8bit\n" + +#. type: Plain text +#: en/about_manual.ssi:92 en/about_manual.ssi:100 en/about_manual.ssi:108 +#: en/about_manual.ssi:116 en/about_manual.ssi:124 en/about_manual.ssi:132 +#: en/appendix_style-guide.ssi:124 en/appendix_style-guide.ssi:134 +#: en/appendix_style-guide.ssi:144 en/appendix_style-guide.ssi:154 +#: en/appendix_style-guide.ssi:164 en/appendix_style-guide.ssi:177 +#: en/examples.ssi:14 en/examples.ssi:30 en/examples.ssi:40 en/examples.ssi:54 +#: en/examples.ssi:67 en/examples.ssi:83 en/examples.ssi:93 +#: en/examples.ssi:106 en/examples.ssi:114 en/examples.ssi:124 +#: en/examples.ssi:134 en/examples.ssi:149 en/examples.ssi:157 +#: en/examples.ssi:165 en/examples.ssi:173 en/examples.ssi:189 +#: en/examples.ssi:203 en/examples.ssi:211 en/examples.ssi:219 +#: en/examples.ssi:235 en/examples.ssi:249 en/examples.ssi:257 +#: en/examples.ssi:265 en/examples.ssi:285 en/examples.ssi:293 +#: en/examples.ssi:302 en/examples.ssi:312 en/project_bugs.ssi:62 +#: en/project_coding-style.ssi:30 en/project_coding-style.ssi:40 +#: en/project_coding-style.ssi:53 en/project_coding-style.ssi:63 +#: en/project_coding-style.ssi:94 en/project_coding-style.ssi:102 +#: en/project_coding-style.ssi:112 en/project_coding-style.ssi:123 +#: en/project_contributing.ssi:34 en/project_contributing.ssi:45 +#: en/project_contributing.ssi:59 en/project_contributing.ssi:68 +#: en/project_contributing.ssi:79 en/project_contributing.ssi:87 +#: en/project_git.ssi:8 en/project_git.ssi:16 en/project_git.ssi:24 +#: en/project_git.ssi:34 en/project_git.ssi:44 en/project_git.ssi:56 +#: en/project_procedures.ssi:39 en/project_procedures.ssi:51 +#: en/user_basics.ssi:50 en/user_basics.ssi:58 en/user_basics.ssi:68 +#: en/user_basics.ssi:86 en/user_basics.ssi:100 en/user_basics.ssi:113 +#: en/user_basics.ssi:121 en/user_basics.ssi:159 en/user_basics.ssi:167 +#: en/user_basics.ssi:179 en/user_basics.ssi:190 en/user_basics.ssi:198 +#: en/user_basics.ssi:210 en/user_basics.ssi:218 en/user_basics.ssi:226 +#: en/user_basics.ssi:238 en/user_basics.ssi:250 en/user_basics.ssi:260 +#: en/user_basics.ssi:270 en/user_basics.ssi:288 en/user_basics.ssi:319 +#: en/user_basics.ssi:335 en/user_basics.ssi:343 en/user_basics.ssi:363 +#: en/user_basics.ssi:390 en/user_basics.ssi:406 +#: en/user_customization-binary.ssi:18 en/user_customization-contents.ssi:24 +#: en/user_customization-contents.ssi:33 en/user_customization-contents.ssi:51 +#: en/user_customization-installer.ssi:32 +#: en/user_customization-installer.ssi:44 +#: en/user_customization-packages.ssi:14 en/user_customization-packages.ssi:22 +#: en/user_customization-packages.ssi:40 en/user_customization-packages.ssi:53 +#: en/user_customization-packages.ssi:67 en/user_customization-packages.ssi:95 +#: en/user_customization-packages.ssi:106 +#: en/user_customization-packages.ssi:114 +#: en/user_customization-packages.ssi:138 +#: en/user_customization-packages.ssi:151 +#: en/user_customization-packages.ssi:161 +#: en/user_customization-packages.ssi:171 +#: en/user_customization-packages.ssi:195 +#: en/user_customization-packages.ssi:211 +#: en/user_customization-packages.ssi:290 +#: en/user_customization-packages.ssi:302 +#: en/user_customization-packages.ssi:312 +#: en/user_customization-packages.ssi:326 +#: en/user_customization-packages.ssi:342 +#: en/user_customization-packages.ssi:359 en/user_customization-runtime.ssi:14 +#: en/user_customization-runtime.ssi:26 en/user_customization-runtime.ssi:44 +#: en/user_customization-runtime.ssi:56 en/user_customization-runtime.ssi:75 +#: en/user_customization-runtime.ssi:83 en/user_customization-runtime.ssi:92 +#: en/user_customization-runtime.ssi:121 en/user_customization-runtime.ssi:131 +#: en/user_customization-runtime.ssi:139 en/user_customization-runtime.ssi:148 +#: en/user_customization-runtime.ssi:157 en/user_customization-runtime.ssi:172 +#: en/user_customization-runtime.ssi:202 en/user_customization-runtime.ssi:210 +#: en/user_customization-runtime.ssi:219 en/user_customization-runtime.ssi:229 +#: en/user_customization-runtime.ssi:237 en/user_customization-runtime.ssi:245 +#: en/user_customization-runtime.ssi:253 en/user_customization-runtime.ssi:261 +#: en/user_customization-runtime.ssi:269 en/user_customization-runtime.ssi:277 +#: en/user_customization-runtime.ssi:285 en/user_installation.ssi:38 +#: en/user_installation.ssi:48 en/user_installation.ssi:56 +#: en/user_installation.ssi:66 en/user_installation.ssi:74 +#: en/user_installation.ssi:82 en/user_installation.ssi:106 +#: en/user_installation.ssi:121 en/user_installation.ssi:134 +#: en/user_managing_a_configuration.ssi:22 +#: en/user_managing_a_configuration.ssi:32 +#: en/user_managing_a_configuration.ssi:55 +#: en/user_managing_a_configuration.ssi:67 +#: en/user_managing_a_configuration.ssi:76 en/user_overview.ssi:34 +#: en/user_overview.ssi:47 en/user_overview.ssi:55 +msgid "code{" +msgstr "" + +#. type: Plain text +#: en/about_manual.ssi:96 en/about_manual.ssi:104 en/about_manual.ssi:112 +#: en/about_manual.ssi:120 en/about_manual.ssi:128 en/about_manual.ssi:136 +#: en/appendix_style-guide.ssi:128 en/appendix_style-guide.ssi:138 +#: en/appendix_style-guide.ssi:148 en/appendix_style-guide.ssi:158 +#: en/appendix_style-guide.ssi:173 en/appendix_style-guide.ssi:182 +#: en/examples.ssi:20 en/examples.ssi:34 en/examples.ssi:44 en/examples.ssi:61 +#: en/examples.ssi:71 en/examples.ssi:89 en/examples.ssi:102 +#: en/examples.ssi:110 en/examples.ssi:118 en/examples.ssi:128 +#: en/examples.ssi:141 en/examples.ssi:153 en/examples.ssi:161 +#: en/examples.ssi:169 en/examples.ssi:177 en/examples.ssi:197 +#: en/examples.ssi:207 en/examples.ssi:215 en/examples.ssi:231 +#: en/examples.ssi:239 en/examples.ssi:253 en/examples.ssi:261 +#: en/examples.ssi:269 en/examples.ssi:289 en/examples.ssi:298 +#: en/examples.ssi:308 en/examples.ssi:324 en/project_bugs.ssi:66 +#: en/project_coding-style.ssi:36 en/project_coding-style.ssi:47 +#: en/project_coding-style.ssi:59 en/project_coding-style.ssi:70 +#: en/project_coding-style.ssi:98 en/project_coding-style.ssi:106 +#: en/project_coding-style.ssi:119 en/project_coding-style.ssi:130 +#: en/project_contributing.ssi:41 en/project_contributing.ssi:55 +#: en/project_contributing.ssi:64 en/project_contributing.ssi:73 +#: en/project_contributing.ssi:83 en/project_contributing.ssi:90 +#: en/project_git.ssi:12 en/project_git.ssi:20 en/project_git.ssi:28 +#: en/project_git.ssi:38 en/project_git.ssi:48 en/project_git.ssi:60 +#: en/project_procedures.ssi:47 en/project_procedures.ssi:92 +#: en/user_basics.ssi:54 en/user_basics.ssi:62 en/user_basics.ssi:72 +#: en/user_basics.ssi:91 en/user_basics.ssi:105 en/user_basics.ssi:117 +#: en/user_basics.ssi:125 en/user_basics.ssi:163 en/user_basics.ssi:171 +#: en/user_basics.ssi:184 en/user_basics.ssi:194 en/user_basics.ssi:202 +#: en/user_basics.ssi:214 en/user_basics.ssi:222 en/user_basics.ssi:230 +#: en/user_basics.ssi:242 en/user_basics.ssi:254 en/user_basics.ssi:264 +#: en/user_basics.ssi:274 en/user_basics.ssi:311 en/user_basics.ssi:323 +#: en/user_basics.ssi:339 en/user_basics.ssi:347 en/user_basics.ssi:374 +#: en/user_basics.ssi:394 en/user_basics.ssi:410 +#: en/user_customization-binary.ssi:25 en/user_customization-contents.ssi:29 +#: en/user_customization-contents.ssi:43 en/user_customization-contents.ssi:55 +#: en/user_customization-installer.ssi:38 +#: en/user_customization-installer.ssi:49 +#: en/user_customization-packages.ssi:18 en/user_customization-packages.ssi:26 +#: en/user_customization-packages.ssi:45 en/user_customization-packages.ssi:59 +#: en/user_customization-packages.ssi:71 +#: en/user_customization-packages.ssi:100 +#: en/user_customization-packages.ssi:110 +#: en/user_customization-packages.ssi:118 +#: en/user_customization-packages.ssi:143 +#: en/user_customization-packages.ssi:157 +#: en/user_customization-packages.ssi:167 +#: en/user_customization-packages.ssi:177 +#: en/user_customization-packages.ssi:201 +#: en/user_customization-packages.ssi:216 +#: en/user_customization-packages.ssi:294 +#: en/user_customization-packages.ssi:306 +#: en/user_customization-packages.ssi:316 +#: en/user_customization-packages.ssi:330 +#: en/user_customization-packages.ssi:355 +#: en/user_customization-packages.ssi:364 en/user_customization-runtime.ssi:18 +#: en/user_customization-runtime.ssi:30 en/user_customization-runtime.ssi:48 +#: en/user_customization-runtime.ssi:69 en/user_customization-runtime.ssi:79 +#: en/user_customization-runtime.ssi:88 en/user_customization-runtime.ssi:97 +#: en/user_customization-runtime.ssi:125 en/user_customization-runtime.ssi:135 +#: en/user_customization-runtime.ssi:144 en/user_customization-runtime.ssi:153 +#: en/user_customization-runtime.ssi:162 en/user_customization-runtime.ssi:180 +#: en/user_customization-runtime.ssi:206 en/user_customization-runtime.ssi:215 +#: en/user_customization-runtime.ssi:223 en/user_customization-runtime.ssi:233 +#: en/user_customization-runtime.ssi:241 en/user_customization-runtime.ssi:249 +#: en/user_customization-runtime.ssi:257 en/user_customization-runtime.ssi:265 +#: en/user_customization-runtime.ssi:273 en/user_customization-runtime.ssi:281 +#: en/user_customization-runtime.ssi:289 en/user_installation.ssi:42 +#: en/user_installation.ssi:52 en/user_installation.ssi:62 +#: en/user_installation.ssi:70 en/user_installation.ssi:78 +#: en/user_installation.ssi:86 en/user_installation.ssi:111 +#: en/user_installation.ssi:128 en/user_installation.ssi:139 +#: en/user_managing_a_configuration.ssi:28 +#: en/user_managing_a_configuration.ssi:43 +#: en/user_managing_a_configuration.ssi:61 +#: en/user_managing_a_configuration.ssi:72 +#: en/user_managing_a_configuration.ssi:80 en/user_overview.ssi:41 +#: en/user_overview.ssi:51 en/user_overview.ssi:59 +msgid "}code" +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:2 +msgid ":B~ Coding Style" +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:4 +msgid "1~coding-style Coding Style" +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:6 +msgid "This chapter documents the coding style used in live systems." +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:8 +msgid "2~ Compatibility" +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:10 +msgid "" +"_* Don't use syntax or semantics that are unique to the Bash shell. For " +"example, the use of array constructs." +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:12 +msgid "_* Only use the POSIX subset - for example, use $(foo) over `foo`." +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:14 +msgid "_* You can check your scripts with 'sh -n' and 'checkbashisms'." +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:16 +msgid "_* Make sure all shell code runs with 'set -e'." +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:18 +msgid "2~ Indenting" +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:20 +msgid "_* Always use tabs over spaces." +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:22 +msgid "2~ Wrapping" +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:24 +msgid "_* Generally, lines are 80 chars at maximum." +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:26 +msgid "_* Use the \"Linux style\" of line breaks:" +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:28 en/project_coding-style.ssi:51 +#: en/project_coding-style.ssi:92 en/project_coding-style.ssi:110 +msgid "Bad:" +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:34 +#, no-wrap +msgid "" +" if foo; then\n" +" bar\n" +" fi\n" +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:38 en/project_coding-style.ssi:61 +#: en/project_coding-style.ssi:100 en/project_coding-style.ssi:121 +msgid "Good:" +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:45 +#, no-wrap +msgid "" +" if foo\n" +" then\n" +" bar\n" +" fi\n" +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:49 +msgid "_* The same holds for functions:" +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:57 +#, no-wrap +msgid "" +" Foo () {\n" +" bar\n" +" }\n" +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:68 +#, no-wrap +msgid "" +" Foo ()\n" +" {\n" +" bar\n" +" }\n" +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:72 +msgid "2~ Variables" +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:74 +msgid "_* Variables are always in capital letters." +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:76 +msgid "_* Variables used in live-build always start with #{LB_}# prefix." +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:78 +msgid "" +"_* Internal temporary variables in live-build should start with the #{\\_LB_}" +"# prefix." +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:80 +msgid "_* Local variables start with live-build #{\\_\\_LB_}# prefix." +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:82 +msgid "" +"_* Variables in connection to a boot parameter in live-config start with " +"#{LIVE_}#." +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:84 +msgid "_* All other variables in live-config start with #{_}# prefix." +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:86 +msgid "" +"_* Use braces around variables; e.g. write #{${FOO}}# instead of #{$FOO}#." +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:88 +msgid "" +"_* Always protect variables with quotes to respect potential whitespaces: " +"write #{\"${FOO}\"}# not #{${FOO}}#." +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:90 +msgid "" +"_* For consistency reasons, always use quotes when assigning values to " +"variables:" +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:96 +#, no-wrap +msgid " FOO=bar\n" +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:104 +#, no-wrap +msgid " FOO=\"bar\"\n" +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:108 +msgid "_* If multiple variables are used, quote the full expression:" +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:117 +#, no-wrap +msgid "" +" if [ -f \"${FOO}\"/foo/\"${BAR}\"/bar ]\n" +" then\n" +" foobar\n" +" fi\n" +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:128 +#, no-wrap +msgid "" +" if [ -f \"${FOO}/foo/${BAR}/bar\" ]\n" +" then\n" +" foobar\n" +" fi\n" +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:132 +msgid "2~ Miscellaneous" +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:134 +msgid "" +"_* Use \"#{|}#\" (without the surround quotes) as a separator in calls to " +"sed, e.g. \"#{sed -e 's|foo|bar|'}#\" (without \"\")." +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:136 +msgid "" +"_* Don't use the #{test}# command for comparisons or tests, use \"#{[}#\" " +"\"#{]}#\" (without \"\"); e.g. \"#{if [ -x /bin/foo ]; ...}#\" and not " +"\"#{if test -x /bin/foo; ...}#\"." +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:138 +msgid "" +"_* Use #{case}# wherever possible over #{test}#, as it's easier to read and " +"faster in execution." +msgstr "" + +#. type: Plain text +#: en/project_coding-style.ssi:139 +msgid "" +"_* Use capitalized names for functions to limit messing with the users " +"environment." +msgstr "" -- cgit v1.2.3