Changeset de33b2a
- Timestamp:
- 03/12/2020 09:24:44 AM (4 years ago)
- Branches:
- 10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
- Children:
- 6ea9f5b3
- Parents:
- 5ab87cfa
- Location:
- general/prog
- Files:
-
- 26 edited
Legend:
- Unmodified
- Added
- Removed
-
general/prog/apache-ant.xml
r5ab87cfa rde33b2a 30 30 <title>Introduction to Apache Ant</title> 31 31 32 <para>The <application>Apache Ant</application> package is a 33 <application>Java</application>-based build tool. In theory, it is 34 like the <command>make</command> command, but without <command>make</command>'s 35 wrinkles. <application>Ant</application> is different. Instead of a model 36 that is extended with shell-based commands, <application>Ant</application> 37 is extended using <application>Java</application> classes. Instead of 38 writing shell commands, the configuration files are XML-based, calling out 39 a target tree that executes various tasks. Each task is run by an object 40 that implements a particular task interface.</para> 32 <para> 33 The <application>Apache Ant</application> package is a 34 <application>Java</application>-based build tool. In theory, it is 35 like the <command>make</command> command, but without 36 <command>make</command>'s wrinkles. <application>Ant</application> is 37 different. Instead of a model that is extended with shell-based commands, 38 <application>Ant</application> is extended using 39 <application>Java</application> classes. Instead of writing shell 40 commands, the configuration files are XML-based, calling out a target 41 tree that executes various tasks. Each task is run by an object that 42 implements a particular task interface. 43 </para> 41 44 42 45 &lfs91_checked; … … 45 48 <itemizedlist spacing="compact"> 46 49 <listitem> 47 <para>Download (HTTP): <ulink url="&apache-ant-download-http;"/></para> 48 </listitem> 49 <listitem> 50 <para>Download (FTP): <ulink url="&apache-ant-download-ftp;"/></para> 51 </listitem> 52 <listitem> 53 <para>Download MD5 sum: &apache-ant-md5sum;</para> 54 </listitem> 55 <listitem> 56 <para>Download size: &apache-ant-size;</para> 57 </listitem> 58 <listitem> 59 <para>Estimated disk space required: &apache-ant-buildsize;</para> 60 </listitem> 61 <listitem> 62 <para>Estimated build time: &apache-ant-time;</para> 50 <para> 51 Download (HTTP): <ulink url="&apache-ant-download-http;"/> 52 </para> 53 </listitem> 54 <listitem> 55 <para> 56 Download (FTP): <ulink url="&apache-ant-download-ftp;"/> 57 </para> 58 </listitem> 59 <listitem> 60 <para> 61 Download MD5 sum: &apache-ant-md5sum; 62 </para> 63 </listitem> 64 <listitem> 65 <para> 66 Download size: &apache-ant-size; 67 </para> 68 </listitem> 69 <listitem> 70 <para> 71 Estimated disk space required: &apache-ant-buildsize; 72 </para> 73 </listitem> 74 <listitem> 75 <para> 76 Estimated build time: &apache-ant-time; 77 </para> 63 78 </listitem> 64 79 </itemizedlist> … … 176 191 <title>Config Files</title> 177 192 178 <para><filename>/etc/ant/ant.conf</filename>, 179 <filename>~/.ant/ant.conf</filename>, and 180 <filename>~/.antrc</filename></para> 193 <para> 194 <filename>/etc/ant/ant.conf</filename>, 195 <filename>~/.ant/ant.conf</filename>, and 196 <filename>~/.antrc</filename> 197 </para> 181 198 182 199 <indexterm zone="apache-ant apache-ant-config"> … … 197 214 <title>Configuration Information</title> 198 215 199 <para>Some packages will require <command>ant</command> to be in the 200 search path and the <envar>ANT_HOME</envar> environment variable 201 defined. Satisfy these requirements by issuing, as the <systemitem 202 class="username">root</systemitem> user:</para> 216 <para> 217 Some packages will require <command>ant</command> to be in the 218 search path and the <envar>ANT_HOME</envar> environment variable 219 defined. Satisfy these requirements by issuing, as the <systemitem 220 class="username">root</systemitem> user: 221 </para> 203 222 204 223 <screen role="root"><userinput>cat > /etc/profile.d/ant.sh << EOF … … 211 230 EOF</userinput></screen> 212 231 213 <para>The above instrutions assume you have configured your system as 214 described in <xref linkend="postlfs-config-profile"/>.</para> 232 <para> 233 The above instructions assume you have configured your system as 234 described in <xref linkend="postlfs-config-profile"/>. 235 </para> 215 236 216 237 </sect3> … … 245 266 <term><command>ant</command></term> 246 267 <listitem> 247 <para>is a <application>Java</application> based build tool used by 248 many packages instead of the conventional <command>make</command> 249 program.</para> 268 <para> 269 is a <application>Java</application> based build tool used by 270 many packages instead of the conventional <command>make</command> 271 program. 272 </para> 250 273 <indexterm zone="apache-ant ant"> 251 274 <primary sortas="b-ant">ant</primary> … … 257 280 <term><command>antRun</command></term> 258 281 <listitem> 259 <para>is a support script used to start <command>ant</command> 260 build scripts in a given directory.</para> 282 <para> 283 is a support script used to start <command>ant</command> 284 build scripts in a given directory. 285 </para> 261 286 <indexterm zone="apache-ant antRun"> 262 287 <primary sortas="b-antRun">antRun</primary> … … 268 293 <term><command>antRun.pl</command></term> 269 294 <listitem> 270 <para>is a <application>Perl</application> script that provides 271 similar functionality offered by the <command>antRun</command> script.</para> 295 <para> 296 is a <application>Perl</application> script that provides similar 297 functionality offered by the <command>antRun</command> script. 298 </para> 272 299 <indexterm zone="apache-ant antRun.pl"> 273 300 <primary sortas="b-antRun.pl">antRun.pl</primary> … … 279 306 <term><command>complete-ant-cmd.pl</command></term> 280 307 <listitem> 281 <para>is a <application>Perl</application> script that allows 282 <application>Bash</application> to complete an <command>ant</command> 283 command-line.</para> 308 <para> 309 is a <application>Perl</application> script that allows 310 <application>Bash</application> to complete an 311 <command>ant</command> command-line. 312 </para> 284 313 <indexterm zone="apache-ant complete-ant-cmd.pl"> 285 314 <primary sortas="b-complete-ant-cmd.pl">complete-ant-cmd.pl</primary> … … 291 320 <term><command>runant.pl</command></term> 292 321 <listitem> 293 <para>is a <application>Perl</application> wrapper script used to 294 invoke <command>ant</command>.</para> 322 <para> 323 is a <application>Perl</application> wrapper script used to 324 invoke <command>ant</command>. 325 </para> 295 326 <indexterm zone="apache-ant runant.pl"> 296 327 <primary sortas="b-runant.pl">runant.pl</primary> … … 302 333 <term><command>runant.py</command></term> 303 334 <listitem> 304 <para>is a <application>Python</application> wrapper script used to 305 invoke <command>ant</command>.</para> 335 <para> 336 is a <application>Python</application> wrapper script used to 337 invoke <command>ant</command>. 338 </para> 306 339 <indexterm zone="apache-ant runant.py"> 307 340 <primary sortas="b-runant.py">runant.py</primary> … … 313 346 <term><filename class='libraryfile'>ant*.jar</filename></term> 314 347 <listitem> 315 <para>files are the <application>Apache Ant</application> 316 <application>Java</application> class libraries.</para> 348 <para> 349 files are the <application>Apache Ant</application> 350 <application>Java</application> class libraries. 351 </para> 317 352 <indexterm zone="apache-ant ant-star"> 318 353 <primary sortas="c-ant-star">ant-*.jar</primary> -
general/prog/clisp.xml
r5ab87cfa rde33b2a 74 74 <itemizedlist spacing='compact'> 75 75 <listitem> 76 <para>Optional patch: <ulink 76 <para> 77 Optional patch: <ulink 77 78 url="&patch-root;/clisp-&clisp-version;-readline7_fixes-1.patch"/> 78 (required if building against libffcall)</para> 79 (required if building against libffcall) 80 </para> 79 81 </listitem> 80 82 </itemizedlist> … … 223 225 <term><command>clisp</command></term> 224 226 <listitem> 225 <para>is an ANSI Common Lisp compiler, interpreter, and debugger</para> 227 <para> 228 is an ANSI Common Lisp compiler, interpreter, and debugger 229 </para> 226 230 <indexterm zone="clisp clisp-prog"> 227 231 <primary sortas="b-clisp">clisp</primary> … … 233 237 <term><command>clisp-link</command></term> 234 238 <listitem> 235 <para>is used to link an external module to clisp</para> 239 <para> 240 is used to link an external module to clisp 241 </para> 236 242 <indexterm zone="clisp clisp-link"> 237 243 <primary sortas="b-clisp-link">clisp-link</primary> -
general/prog/decorator.xml
r5ab87cfa rde33b2a 74 74 <title>Installation of decorator</title> 75 75 76 <para>Install decorator with the following commands:</para> 76 <para> 77 Install <application>decorator</application> with the following 78 commands: 79 </para> 77 80 78 81 <screen><userinput>python3 setup.py build</userinput></screen> -
general/prog/doxygen.xml
r5ab87cfa rde33b2a 90 90 <itemizedlist spacing='compact'> 91 91 <listitem> 92 <para>Required patch: <ulink 93 url="&patch-root;/doxygen-&doxygen-version;-flex_2_6_0_fix-1.patch"/></para> 92 <para> 93 Required patch: <ulink 94 url="&patch-root;/doxygen-&doxygen-version;-flex_2_6_0_fix-1.patch"/> 95 </para> 94 96 </listitem> 95 97 </itemizedlist>--> -
general/prog/expect.xml
r5ab87cfa rde33b2a 30 30 <title>Introduction to Expect</title> 31 31 32 <para>The <application>Expect</application> package was installed in the 33 LFS temporary tools directory for testing other packages. These 34 procedures install it in a permanent location. It contains tools for 35 automating interactive applications such as <command>telnet</command>, 36 <command>ftp</command>, <command>passwd</command>, 37 <command>fsck</command>, <command>rlogin</command>, 38 <command>tip</command>, etc. <application>Expect</application> is 39 also useful for testing these same applications as well as easing all sorts of 40 tasks that are prohibitively difficult with anything else.</para> 32 <para> 33 The <application>Expect</application> package was installed in the 34 LFS temporary tools directory for testing other packages. These 35 procedures install it in a permanent location. It contains tools for 36 automating interactive applications such as <command>telnet</command>, 37 <command>ftp</command>, <command>passwd</command>, 38 <command>fsck</command>, <command>rlogin</command>, 39 <command>tip</command>, etc. <application>Expect</application> is also 40 useful for testing these same applications as well as easing all sorts of 41 tasks that are prohibitively difficult with anything else. 42 </para> 41 43 42 44 &lfs91_checked; … … 45 47 <itemizedlist spacing="compact"> 46 48 <listitem> 47 <para>Download (HTTP): <ulink url="&expect-download-http;"/></para> 49 <para> 50 Download (HTTP): <ulink url="&expect-download-http;"/> 51 </para> 48 52 </listitem> 49 53 <!-- <listitem> 50 <para>Download (FTP): <ulink url="&expect-download-ftp;"/></para> 54 <para> 55 Download (FTP): <ulink url="&expect-download-ftp;"/> 56 </para> 51 57 </listitem> --> 52 58 <listitem> 53 <para>Download MD5 sum: &expect-md5sum;</para> 59 <para> 60 Download MD5 sum: &expect-md5sum; 61 </para> 54 62 </listitem> 55 63 <listitem> 56 <para>Download size: &expect-size;</para> 64 <para> 65 Download size: &expect-size; 66 </para> 57 67 </listitem> 58 68 <listitem> 59 <para>Estimated disk space required: &expect-buildsize;</para> 69 <para> 70 Estimated disk space required: &expect-buildsize; 71 </para> 60 72 </listitem> 61 73 <listitem> 62 <para>Estimated build time: &expect-time;</para> 74 <para> 75 Estimated build time: &expect-time; 76 </para> 63 77 </listitem> 64 78 </itemizedlist> … … 80 94 <title>Installation of Expect</title> 81 95 82 <para>Install <application>Expect</application> by running the following 83 commands:</para> 96 <para> 97 Install <application>Expect</application> by running the following 98 commands: 99 </para> 84 100 85 101 <!-- Not sure if we need a static library as it does not build by default … … 93 109 make</userinput></screen> 94 110 95 <para>To test the results, issue: <command>make test</command>.</para> 96 97 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 111 <para> 112 To test the results, issue: <command>make test</command>. 113 </para> 114 115 <para> 116 Now, as the <systemitem class="username">root</systemitem> user: 117 </para> 98 118 99 119 <screen role="root"><userinput>make install && … … 105 125 <title>Command Explanations</title> 106 126 107 <para><parameter>-with-tcl=/usr/lib</parameter>: This parameter is used to 108 tell the <command>configure</command> script where the 109 <command>tclConfig.sh</command> is located.</para> 110 111 <para><parameter>--enable-shared</parameter>: This option enables 112 building the shared library.</para> 127 <para> 128 <parameter>-with-tcl=/usr/lib</parameter>: This parameter is used to 129 tell the <command>configure</command> script where the 130 <command>tclConfig.sh</command> is located. 131 </para> 132 133 <para> 134 <parameter>--enable-shared</parameter>: This option enables 135 building the shared library. 136 </para> 113 137 114 138 <!-- Not really sure if this is required any longer as the library is now 115 139 installed directly in /usr/lib/expect5.45/. --> 116 <para><command>ln -sf ...</command>: This command creates a required link 117 to the shared library.</para> 140 <para> 141 <command>ln -sf ...</command>: This command creates a required link 142 to the shared library. 143 </para> 118 144 119 145 </sect2> … … 125 151 <title>Config Files</title> 126 152 127 <para><filename>$exp_library/expect.rc</filename> and 128 <filename>~/.expect.rc</filename></para> 153 <para> 154 <filename>$exp_library/expect.rc</filename> and 155 <filename>~/.expect.rc</filename> 156 </para> 129 157 130 158 <indexterm zone="expect expect-config"> … … 141 169 <title>Configuration Information</title> 142 170 143 <para>Reference the <command>expect</command> man page for information about 144 utilizing the <filename>expect.rc</filename> configuration files. Additionally, 145 many of the tools contained in the <application>Expect</application> package 146 will use their own configuration files. Reference the respective man page, or 147 examine the script directly for configuration file information.</para> 171 <para> 172 Reference the <command>expect</command> man page for information about 173 utilizing the <filename>expect.rc</filename> configuration files. 174 Additionally, many of the tools contained in the 175 <application>Expect</application> package will use their own 176 configuration files. Reference the respective man page, or 177 examine the script directly for configuration file information. 178 </para> 148 179 149 180 </sect3> … … 178 209 <term><command>autoexpect</command></term> 179 210 <listitem> 180 <para>generates an <application>Expect</application> script from 181 watching a session.</para> 211 <para> 212 generates an <application>Expect</application> script from 213 watching a session. 214 </para> 182 215 <indexterm zone="expect autoexpect"> 183 216 <primary sortas="b-autoexpect">autoexpect</primary> … … 189 222 <term><command>autopasswd</command></term> 190 223 <listitem> 191 <para>is a wrapper to make <command>passwd</command>(1) be 192 non-interactive.</para> 224 <para> 225 is a wrapper to make <command>passwd</command>(1) be 226 non-interactive. 227 </para> 193 228 <indexterm zone="expect autopasswd"> 194 229 <primary sortas="b-autopasswd">autopasswd</primary> … … 200 235 <term><command>cryptdir</command></term> 201 236 <listitem> 202 <para>encrypts all files in a directory.</para> 237 <para> 238 encrypts all files in a directory. 239 </para> 203 240 <indexterm zone="expect cryptdir"> 204 241 <primary sortas="b-cryptdir">cryptdir</primary> … … 210 247 <term><command>decryptdir</command></term> 211 248 <listitem> 212 <para>decrypts all files in a directory.</para> 249 <para> 250 decrypts all files in a directory. 251 </para> 213 252 <indexterm zone="expect decryptdir"> 214 253 <primary sortas="b-decryptdir">decryptdir</primary> … … 220 259 <term><command>dislocate</command></term> 221 260 <listitem> 222 <para>allows processes to be disconnected and reconnected to a 223 terminal.</para> 261 <para> 262 allows processes to be disconnected and reconnected to a 263 terminal. 264 </para> 224 265 <indexterm zone="expect dislocate"> 225 266 <primary sortas="b-dislocate">dislocate</primary> … … 231 272 <term><command>expect</command></term> 232 273 <listitem> 233 <para>is a program that <quote>talks</quote> to other interactive 234 programs according to a script.</para> 274 <para> 275 is a program that <quote>talks</quote> to other interactive 276 programs according to a script. 277 </para> 235 278 <indexterm zone="expect expect-prog"> 236 279 <primary sortas="b-expect">expect</primary> … … 242 285 <term><command>ftp-rfc</command></term> 243 286 <listitem> 244 <para>retrieves an RFC (or the index) from UUNET.</para> 287 <para> 288 retrieves an RFC (or the index) from UUNET. 289 </para> 245 290 <indexterm zone="expect ftp-rfc"> 246 291 <primary sortas="b-ftp-rfc">ftp-rfc</primary> … … 252 297 <term><command>kibitz</command></term> 253 298 <listitem> 254 <para>allows two (or more) people to interact with one shell 255 (or any arbitrary program).</para> 299 <para> 300 allows two (or more) people to interact with one shell 301 (or any arbitrary program). 302 </para> 256 303 <indexterm zone="expect kibitz"> 257 304 <primary sortas="b-kibitz">kibitz</primary> … … 263 310 <term><command>lpunlock</command></term> 264 311 <listitem> 265 <para>unhangs a printer which claims it is <quote>waiting for 266 lock</quote>.</para> 312 <para> 313 unhangs a printer which claims it is <quote>waiting for 314 lock</quote>. 315 </para> 267 316 <indexterm zone="expect lpunlock"> 268 317 <primary sortas="b-lpunlock">lpunlock</primary> … … 274 323 <term><command>mkpasswd</command></term> 275 324 <listitem> 276 <para>generates passwords and can apply them automatically to 277 users.</para> 325 <para> 326 generates passwords and can apply them automatically to users. 327 </para> 278 328 <indexterm zone="expect mkpasswd"> 279 329 <primary sortas="b-mkpasswd">mkpasswd</primary> … … 285 335 <term><command>passmass</command></term> 286 336 <listitem> 287 <para>changes a password on multiple machines.</para> 337 <para> 338 changes a password on multiple machines. 339 </para> 288 340 <indexterm zone="expect passmass"> 289 341 <primary sortas="b-passmass">passmass</primary> … … 295 347 <term><command>rftp</command></term> 296 348 <listitem> 297 <para>is much like <command>ftp</command> except it uses 298 <option>~g</option> and <option>~p</option> instead of 299 <option>mget</option> and <option>mput</option>.</para> 349 <para> 350 is much like <command>ftp</command> except it uses 351 <option>~g</option> and <option>~p</option> instead of 352 <option>mget</option> and <option>mput</option>. 353 </para> 300 354 <indexterm zone="expect rftp"> 301 355 <primary sortas="b-rftp">rftp</primary> … … 307 361 <term><command>rlogin-cwd</command></term> 308 362 <listitem> 309 <para>is <command>rlogin</command> except it uses the local current 310 directory as the current working directory on the remote machine.</para> 363 <para> 364 is <command>rlogin</command> except it uses the local current 365 directory as the current working directory on the remote machine. 366 </para> 311 367 <indexterm zone="expect rlogin-cwd"> 312 368 <primary sortas="b-rlogin-cwd">rlogin-cwd</primary> … … 318 374 <term><command>timed-read</command></term> 319 375 <listitem> 320 <para> reads a complete line from stdin and aborts after a given 321 number of seconds.</para> 376 <para> 377 reads a complete line from stdin and aborts after a given 378 number of seconds. 379 </para> 322 380 <indexterm zone="expect timed-read"> 323 381 <primary sortas="b-timed-read">timed-read</primary> … … 329 387 <term><command>timed-run</command></term> 330 388 <listitem> 331 <para>runs a program for a given amount of time.</para> 389 <para> 390 runs a program for a given amount of time. 391 </para> 332 392 <indexterm zone="expect timed-run"> 333 393 <primary sortas="b-timed-run">timed-run</primary> … … 339 399 <term><command>unbuffer</command></term> 340 400 <listitem> 341 <para>disables the output buffering that occurs when program output 342 is redirected.</para> 401 <para> 402 disables the output buffering that occurs when program output 403 is redirected. 404 </para> 343 405 <indexterm zone="expect unbuffer"> 344 406 <primary sortas="b-unbuffer">unbuffer</primary> … … 350 412 <term><command>weather</command></term> 351 413 <listitem> 352 <para>retrieves a weather report (courtesy University of Michigan) 353 for a given city or geographical area.</para> 414 <para> 415 retrieves a weather report (courtesy University of Michigan) 416 for a given city or geographical area. 417 </para> 354 418 <indexterm zone="expect weather"> 355 419 <primary sortas="b-weather">weather</primary> … … 361 425 <term><command>multixterm</command></term> 362 426 <listitem> 363 <para>creates multiple <command>xterm</command>s that can be driven 364 together or separately.</para> 427 <para> 428 creates multiple <command>xterm</command>s that can be driven 429 together or separately. 430 </para> 365 431 <indexterm zone="expect multixterm"> 366 432 <primary sortas="b-multixterm">multixterm</primary> … … 372 438 <term><command>tknewsbiff</command></term> 373 439 <listitem> 374 <para>pops up a window when there is unread news in your favorite 375 newsgroups and removes the window after you've read the news.</para> 440 <para> 441 pops up a window when there is unread news in your favorite 442 newsgroups and removes the window after you've read the news. 443 </para> 376 444 <indexterm zone="expect tknewsbiff"> 377 445 <primary sortas="b-tknewsbiff">tknewsbiff</primary> … … 383 451 <term><command>tkpasswd</command></term> 384 452 <listitem> 385 <para>is a script to change passwords using 386 <command>expect</command> and <application>Tk</application>.</para> 453 <para> 454 is a script to change passwords using 455 <command>expect</command> and <application>Tk</application>. 456 </para> 387 457 <indexterm zone="expect tkpasswd"> 388 458 <primary sortas="b-tkpasswd">tkpasswd</primary> … … 394 464 <term><command>xkibitz</command></term> 395 465 <listitem> 396 <para>allows users in separate <command>xterm</command>s to share 397 one shell (or any program that runs in an <command>xterm</command>).</para> 466 <para> 467 allows users in separate <command>xterm</command>s to share one 468 shell (or any program that runs in an <command>xterm</command>). 469 </para> 398 470 <indexterm zone="expect xkibitz"> 399 471 <primary sortas="b-xkibitz">xkibitz</primary> … … 405 477 <term><command>xpstat</command></term> 406 478 <listitem> 407 <para>is a script that acts as a front-end for <command>xpilot</command>.</para> 479 <para> 480 is a script that acts as a front-end for <command>xpilot</command>. 481 </para> 408 482 <indexterm zone="expect xpstat"> 409 483 <primary sortas="b-xpstat">xpstat</primary> … … 415 489 <term><filename class='libraryfile'>libexpect&expect-version;.so</filename></term> 416 490 <listitem> 417 <para> contains functions that allow <application>Expect</application> to be 418 used as a <application>Tcl</application> extension or to be used directly from 419 C or C++ (without <application>Tcl</application>).</para> 491 <para> 492 contains functions that allow <application>Expect</application> to 493 be used as a <application>Tcl</application> extension or to be 494 used directly from C or C++ (without 495 <application>Tcl</application>). 496 </para> 420 497 <indexterm zone="expect libexpect"> 421 498 <primary sortas="c-libexpect&expect-version;">libexpect&expect-version;.so</primary> -
general/prog/java.xml
r5ab87cfa rde33b2a 41 41 <sect2> 42 42 <title>About Java</title> 43 <para>Java is different from most of the packages in LFS and BLFS. It 44 is a programming language that works with files of byte codes to obtain 45 instructions and executes then in a Java Virtual Machine (JVM). An 46 introductory java program looks like:</para> 43 <para> 44 Java is different from most of the packages in LFS and BLFS. It 45 is a programming language that works with files of byte codes to obtain 46 instructions and executes then in a Java Virtual Machine (JVM). An 47 introductory java program looks like: 48 </para> 47 49 48 50 <screen><literal>public class HelloWorld … … 54 56 }</literal></screen> 55 57 56 <para>This program is saved as <filename>HelloWorld.java</filename>. The 57 file name, <emphasis>HelloWorld</emphasis>, must match the class name. It 58 is then converted into byte code with 59 <command>javac HelloWorld.java</command>. The output file is 60 <filename>HelloWorld.class</filename>. The program is executed with 61 <command>java HelloWorld</command>. This creates a JVM and runs the 62 code. The 'class' extension must not be specified.</para> 58 <para> 59 This program is saved as <filename>HelloWorld.java</filename>. The 60 file name, <emphasis>HelloWorld</emphasis>, must match the class name. 61 It is then converted into byte code with 62 <command>javac HelloWorld.java</command>. The output file is 63 <filename>HelloWorld.class</filename>. The program is executed with 64 <command>java HelloWorld</command>. This creates a JVM and runs the 65 code. The 'class' extension must not be specified. 66 </para> 63 67 64 <para>Several class files can be combined into one file with the 65 <command>jar</command> command. This is similar to the standard 66 <command>tar</command> command. For instance, the command 67 <command>jar cf myjar.jar *.class</command> will combine all class files 68 in a directory into one jar file. These act as library files.</para> 68 <para> 69 Several class files can be combined into one file with the 70 <command>jar</command> command. This is similar to the standard 71 <command>tar</command> command. For instance, the command 72 <command>jar cf myjar.jar *.class</command> will combine all class files 73 in a directory into one jar file. These act as library files. 74 </para> 69 75 70 <para>The JVM can search for and use classes in jar files automatically. 71 It uses the <envar>CLASSPATH</envar> environment variable to search for 72 jar files. This is a standard list of colon-separated directory names 73 similar to the <envar>PATH</envar> environment variable.</para> 76 <para> 77 The JVM can search for and use classes in jar files automatically. 78 It uses the <envar>CLASSPATH</envar> environment variable to search for 79 jar files. This is a standard list of colon-separated directory names 80 similar to the <envar>PATH</envar> environment variable. 81 </para> 74 82 75 83 </sect2> … … 78 86 <title>Binary JDK Information</title> 79 87 80 <para>Creating a JVM from source requires a set of circular dependencies. 81 The first thing that's needed is a set of programs called a Java Development 82 Kit (JDK). This set of programs includes <command>java</command>, 83 <command>javac</command>, <command>jar</command>, and several others. It 84 also includes several base <emphasis>jar</emphasis> files.</para> 88 <para> 89 Creating a JVM from source requires a set of circular dependencies. 90 The first thing that's needed is a set of programs called a Java 91 Development Kit (JDK). This set of programs includes 92 <command>java</command>, <command>javac</command>, 93 <command>jar</command>, and several others. It also includes several 94 base <emphasis>jar</emphasis> files. 95 </para> 85 96 86 <para>To start, we set up a binary installation of the JDK created 87 by the BLFS editors. It is installed in the <filename>/opt</filename> 88 directory to allow for multiple installations, including a source based 89 version.</para> 97 <para> 98 To start, we set up a binary installation of the JDK created 99 by the BLFS editors. It is installed in the <filename>/opt</filename> 100 directory to allow for multiple installations, including a source based 101 version. 102 </para> 90 103 91 104 &lfs91_checked; … … 94 107 <itemizedlist spacing="compact"> 95 108 <listitem> 96 <para>Binary download (x86): 97 <ulink url="&openjdk-download-binary-x86;"/></para> 109 <para> 110 Binary download (x86): <ulink url="&openjdk-download-binary-x86;"/> 111 </para> 98 112 </listitem> 99 113 <listitem> 100 <para>Download MD5 sum: &openjdk-bin-md5sum-x86;</para> 114 <para> 115 Download MD5 sum: &openjdk-bin-md5sum-x86; 116 </para> 101 117 </listitem> 102 118 <listitem> 103 <para>Download size (binary): &openjdk-bin-size-x86;</para> 119 <para> 120 Download size (binary): &openjdk-bin-size-x86; 121 </para> 104 122 </listitem> 105 123 <listitem> 106 <para>Estimated disk space required: &openjdk-bin-buildsize-x86;</para> 124 <para> 125 Estimated disk space required: &openjdk-bin-buildsize-x86; 126 </para> 107 127 </listitem> 108 128 </itemizedlist> 109 129 <itemizedlist spacing="compact"> 110 130 <listitem> 111 <para>Binary download (x86_64): 112 <ulink url="&openjdk-download-binary-x64;"/></para> 131 <para> 132 Binary download (x86_64): <ulink url="&openjdk-download-binary-x64;"/> 133 </para> 113 134 </listitem> 114 135 <listitem> 115 <para>Download MD5 sum: &openjdk-bin-md5sum-x64;</para> 136 <para> 137 Download MD5 sum: &openjdk-bin-md5sum-x64; 138 </para> 116 139 </listitem> 117 140 <listitem> 118 <para>Download size (binary): &openjdk-bin-size-x64;</para> 141 <para> 142 Download size (binary): &openjdk-bin-size-x64; 143 </para> 119 144 </listitem> 120 145 <listitem> 121 <para>Estimated disk space required: &openjdk-bin-buildsize-x64;</para> 146 <para> 147 Estimated disk space required: &openjdk-bin-buildsize-x64; 148 </para> 122 149 </listitem> 123 150 </itemizedlist> … … 135 162 <sect2 role="installation"> 136 163 <title>Installation of the Java BinaryJDK </title> 137 <para>Begin by extracting the appropriate binary tarball for your 138 architecture and changing to the extracted directory. Install the binary 139 <application>OpenJDK</application> with the following commands as the 140 <systemitem class="username">root</systemitem> user:</para> 164 <para> 165 Begin by extracting the appropriate binary tarball for your 166 architecture and changing to the extracted directory. Install the binary 167 <application>OpenJDK</application> with the following commands as the 168 <systemitem class="username">root</systemitem> user: 169 </para> 141 170 142 171 <screen role="root"><userinput>install -vdm755 /opt/OpenJDK-&openjdk-version;+&openjdk-build;-bin && -
general/prog/lua.xml
r5ab87cfa rde33b2a 122 122 <title>Installation of Lua</title> 123 123 124 <para>Some packages check for the <application>pkg-config</application> file 125 for <application>Lua</application>, which is created with:</para> 124 <para> 125 Some packages check for the <application>pkg-config</application> file 126 for <application>Lua</application>, which is created with: 127 </para> 126 128 127 129 <screen><userinput>cat > lua.pc << "EOF" -
general/prog/lua52.xml
r5ab87cfa rde33b2a 100 100 <title>Installation of Lua 5.2</title> 101 101 102 <para>Some packages check for the <application>pkg-config</application> file 103 for <application>Lua</application>, which is created with:</para> 102 <para> 103 Some packages check for the <application>pkg-config</application> file 104 for <application>Lua</application>, which is created with: 105 </para> 104 106 105 107 <screen><userinput>cat > lua.pc << "EOF" -
general/prog/mercurial.xml
r5ab87cfa rde33b2a 30 30 <title>Introduction to Mercurial</title> 31 31 32 <para><application>Mercurial</application> is a distributed source control 33 management tool similar to <application>Git</application> and 34 <application>Bazaar</application>. <application>Mercurial</application> is 35 written in <application>Python</application> and is used by projects such as 36 Mozilla and Vim.</para> 32 <para> 33 <application>Mercurial</application> is a distributed source control 34 management tool similar to <application>Git</application> and 35 <application>Bazaar</application>. <application>Mercurial</application> 36 is written in <application>Python</application> and is used by projects 37 such as Mozilla and Vim. 38 </para> 37 39 38 40 &lfs91_checked; … … 41 43 <itemizedlist spacing="compact"> 42 44 <listitem> 43 <para>Download (HTTP): <ulink url="&mercurial-download-http;"/></para> 44 </listitem> 45 <listitem> 46 <para>Download (FTP): <ulink url="&mercurial-download-ftp;"/></para> 47 </listitem> 48 <listitem> 49 <para>Download MD5 sum: &mercurial-md5sum;</para> 50 </listitem> 51 <listitem> 52 <para>Download size: &mercurial-size;</para> 53 </listitem> 54 <listitem> 55 <para>Estimated disk space required: &mercurial-buildsize;</para> 56 </listitem> 57 <listitem> 58 <para>Estimated build time: &mercurial-time;</para> 45 <para> 46 Download (HTTP): <ulink url="&mercurial-download-http;"/> 47 </para> 48 </listitem> 49 <listitem> 50 <para> 51 Download (FTP): <ulink url="&mercurial-download-ftp;"/> 52 </para> 53 </listitem> 54 <listitem> 55 <para> 56 Download MD5 sum: &mercurial-md5sum; 57 </para> 58 </listitem> 59 <listitem> 60 <para> 61 Download size: &mercurial-size; 62 </para> 63 </listitem> 64 <listitem> 65 <para> 66 Estimated disk space required: &mercurial-buildsize; 67 </para> 68 </listitem> 69 <listitem> 70 <para> 71 Estimated build time: &mercurial-time; 72 </para> 59 73 </listitem> 60 74 </itemizedlist> … … 93 107 <!-- seems to have a development rust port --> 94 108 95 <para>Build <application>Mercurial</application> by issuing the following 96 command:</para> 109 <para> 110 Build <application>Mercurial</application> by issuing the following 111 command: 112 </para> 97 113 98 114 <screen><userinput>make build</userinput></screen> 99 115 100 <para>To build the documentation (requires <xref linkend="docutils"/>), 101 issue:</para> 116 <para> 117 To build the documentation (requires <xref linkend="docutils"/>), issue: 118 </para> 102 119 103 120 <screen remap="doc"><userinput>2to3 -w doc/hgmanpage.py && 104 121 PYTHON=python3 make doc</userinput></screen> 105 122 106 <!-- All tests pass (or are skipped) at version 3.8.2107 <para>Running the test suite is optional. Tests which fail may be disabled,108 adding each one to <filename>tests/blacklists/failed-tests</filename>. In109 order to execute the test suite using the temporary directory <filename110 class="directory">tests/tmp</filename> and skipping the failing tests,111 issue:</para>112 113 Version 5.2.1 had one failure test-bundle2-exchange.t114 115 116 <screen remap="test"><userinput>cat > tests/blacklists/failed-tests << "EOF"117 <literal># Test Failures118 test-gpg.t</literal>119 EOF120 -->121 123 <para> 122 124 To run the test suite, issue: … … 127 129 of tests/blacklists, but do not include the makefile. --> 128 130 129 <para>where <replaceable><N></replaceable> is an integer between one 130 and the number of ( processor X threads ), inclusive. In order to 131 investigate any apparently failing tests, you may use the 132 <command>run-tests.py</command> script. To see the almost forty switches, 133 some of them very useful, issue <command>tests/run-tests.py 134 --help</command>. Running the following commands, you will execute only 135 the tests that failed before:</para> 131 <para> 132 where <replaceable><N></replaceable> is an integer between one 133 and the number of ( processor X threads ), inclusive. In order to 134 investigate any apparently failing tests, you may use the 135 <command>run-tests.py</command> script. To see the almost forty switches, 136 some of them very useful, issue <command>tests/run-tests.py 137 --help</command>. Running the following commands, you will execute only 138 the tests that failed before: 139 </para> 136 140 137 141 <screen remap="test"><userinput>pushd tests && … … 140 144 popd</userinput></screen> 141 145 142 <para>Normally, the previous failures will be confirmed. However, if 143 you add the switch 144 "--debug" before "--tmpdir", and run again, some failures are gone, which 145 seems to be a problem with the test suite. If this happens, normally, from 146 now on, there will be no more such failures whether you use the debug switch 147 or not. Three tests, test-alias.t, test-install.t, and 148 test-bundle2-exchange.t (intermittently), are known to fail.</para> 149 150 <para>An interesting switch is "--time", which will generate at the end of 151 the test suite execution, a table with all executed tests and respective 152 start, end, user, system and real times. Note that the switches may be 153 used with <command>make check</command> by including them in the 154 <envar>TESTFLAGS</envar> environment variable.</para> 155 156 <para>Install <application>Mercurial</application> by running the following 157 command (as <systemitem class="username">root</systemitem>):</para> 146 <para> 147 Normally, the previous failures will be confirmed. However, if 148 you add the switch <option>--debug</option> before 149 <option>--tmpdir</option>, and run again, some failures are gone, which 150 seems to be a problem with the test suite. If this happens, normally, 151 from now on, there will be no more such failures whether you use the 152 debug switch or not. Three tests, test-alias.t, test-install.t, and 153 test-bundle2-exchange.t (intermittently), are known to fail. 154 </para> 155 156 <para> 157 An interesting switch is <option>--time</option>, which will generate at 158 the end of the test suite execution, a table with all executed tests and 159 respective start, end, user, system and real times. Note that the 160 switches may be used with <command>make check</command> by including 161 them in the <envar>TESTFLAGS</envar> environment variable. 162 </para> 163 164 <para> 165 Install <application>Mercurial</application> by running the following 166 command (as <systemitem class="username">root</systemitem>): 167 </para> 158 168 159 169 <screen role="root"><userinput>make PREFIX=/usr install-bin</userinput></screen> 160 170 161 <para>If you built the documentation, install it by running the following 162 command (as <systemitem class="username">root</systemitem>):</para> 171 <para> 172 If you built the documentation, install it by running the following 173 command (as <systemitem class="username">root</systemitem>): 174 </para> 163 175 164 176 <screen role="root" 165 177 remap="doc"><userinput>make PREFIX=/usr install-doc</userinput></screen> 166 178 167 <para>After installation, two very quick and simple tests should run 168 correctly. The first one needs some configuration:</para> 179 <para> 180 After installation, two very quick and simple tests should run 181 correctly. The first one needs some configuration: 182 </para> 169 183 170 184 <screen><userinput>cat >> ~/.hgrc << "EOF" … … 173 187 EOF</userinput></screen> 174 188 175 <para>where you must replace <user_name> and <your@mail> (mail 176 is optional and can be omitted). With the user identity defined, run 177 <command>hg debuginstall</command> and several lines will be displayed, 178 the last one reading "no problems detected". Another quick and simple test 179 is just <command>hg</command>, which should output basic commands that can 180 be used with <command>hg</command>.</para> 189 <para> 190 where you must replace <user_name> and <your@mail> (mail 191 is optional and can be omitted). With the user identity defined, run 192 <command>hg debuginstall</command> and several lines will be displayed, 193 the last one reading "no problems detected". Another quick and simple 194 test is just <command>hg</command>, which should output basic commands 195 that can be used with <command>hg</command>. 196 </para> 181 197 182 198 </sect2> … … 211 227 </indexterm> 212 228 213 <para>The great majority of extensions are disabled by default. Run 214 <command>hg help extensions</command> if you need to enable any, e.g. 215 when investigating test failures. You will obtain the lists of enabled and 216 disabled extensions, and more information, such as how to enable or 217 disable them using configuration files.</para> 218 219 <para>If you have installed <xref linkend="make-ca"/> and want 220 <application>Mercurial</application> to use them, as the <systemitem 221 class="username">root</systemitem> user, issue:</para> 229 <para> 230 The great majority of extensions are disabled by default. Run 231 <command>hg help extensions</command> if you need to enable any, e.g. 232 when investigating test failures. You will obtain the lists of enabled 233 and disabled extensions, and more information, such as how to enable 234 or disable them using configuration files. 235 </para> 236 237 <para> 238 If you have installed <xref linkend="make-ca"/> and want 239 <application>Mercurial</application> to use them, as the <systemitem 240 class="username">root</systemitem> user, issue: 241 </para> 222 242 223 243 <screen role="root"><userinput>install -v -d -m755 /etc/mercurial && … … 262 282 <term><command>hg</command></term> 263 283 <listitem> 264 <para>is the mercurial version control system.</para> 284 <para> 285 is the mercurial version control system. 286 </para> 265 287 <indexterm zone="mercurial hg"> 266 288 <primary sortas="b-hg">hg</primary> -
general/prog/nasm.xml
r5ab87cfa rde33b2a 30 30 <title>Introduction to NASM</title> 31 31 32 <para><application>NASM</application> (Netwide Assembler) 33 is an 80x86 assembler designed for portability and modularity. It includes a 34 disassembler as well.</para> 32 <para> 33 <application>NASM</application> (Netwide Assembler) is an 80x86 34 assembler designed for portability and modularity. It includes a 35 disassembler as well. 36 </para> 35 37 36 38 &lfs91_checked; … … 39 41 <itemizedlist spacing="compact"> 40 42 <listitem> 41 <para>Download (HTTP): <ulink url="&nasm-download-http;"/></para> 43 <para> 44 Download (HTTP): <ulink url="&nasm-download-http;"/> 45 </para> 42 46 </listitem> 43 47 <listitem> 44 <para>Download (FTP): <ulink url="&nasm-download-ftp;"/></para> 48 <para> 49 Download (FTP): <ulink url="&nasm-download-ftp;"/> 50 </para> 45 51 </listitem> 46 52 <listitem> 47 <para>Download MD5 sum: &nasm-md5sum;</para> 53 <para> 54 Download MD5 sum: &nasm-md5sum; 55 </para> 48 56 </listitem> 49 57 <listitem> 50 <para>Download size: &nasm-size;</para> 58 <para> 59 Download size: &nasm-size; 60 </para> 51 61 </listitem> 52 62 <listitem> 53 <para>Estimated disk space required: &nasm-buildsize;</para> 63 <para> 64 Estimated disk space required: &nasm-buildsize; 65 </para> 54 66 </listitem> 55 67 <listitem> 56 <para>Estimated build time: &nasm-time;</para> 68 <para> 69 Estimated build time: &nasm-time; 70 </para> 57 71 </listitem> 58 72 </itemizedlist> … … 61 75 <itemizedlist spacing="compact"> 62 76 <listitem> 63 <para>Optional documentation: <ulink 64 url="http://www.nasm.us/pub/nasm/releasebuilds/&nasm-version;/nasm-&nasm-version;-xdoc.tar.xz"/></para> 77 <para> 78 Optional documentation: <ulink 79 url="http://www.nasm.us/pub/nasm/releasebuilds/&nasm-version;/nasm-&nasm-version;-xdoc.tar.xz"/> 80 </para> 65 81 </listitem> 66 82 </itemizedlist> … … 82 98 <title>Installation of NASM</title> 83 99 84 <para>If you downloaded the optional documentation, put it into the 85 source tree:</para> 100 <para> 101 If you downloaded the optional documentation, put it into the 102 source tree: 103 </para> 86 104 87 105 <screen><userinput>tar -xf ../nasm-&nasm-version;-xdoc.tar.xz --strip-components=1</userinput></screen> 88 106 89 <para>Install <application>NASM</application> by running 90 the following commands:</para> 107 <para> 108 Install <application>NASM</application> by running 109 the following commands: 110 </para> 91 111 92 112 <screen><userinput>./configure --prefix=/usr && 93 113 make</userinput></screen> 94 114 95 <para>This package does not come with a test suite.</para> 115 <para> 116 This package does not come with a test suite. 117 </para> 96 118 97 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 119 <para> 120 Now, as the <systemitem class="username">root</systemitem> user: 121 </para> 98 122 99 123 <!-- dev note: make INSTALLROOT=<DESTDIR> install --> … … 101 125 <screen role="root"><userinput>make install</userinput></screen> 102 126 103 <para>If you downloaded the optional documentation, install it with the 104 following instructions as the <systemitem 105 class="username">root</systemitem> user:</para> 127 <para> 128 If you downloaded the optional documentation, install it with the 129 following instructions as the <systemitem 130 class="username">root</systemitem> user: 131 </para> 106 132 107 133 <screen role="root"><userinput>install -m755 -d /usr/share/doc/nasm-&nasm-version;/html && … … 134 160 <term><command>nasm</command></term> 135 161 <listitem> 136 <para>is a portable 80x86 assembler.</para> 162 <para> 163 is a portable 80x86 assembler. 164 </para> 137 165 <indexterm zone="nasm nasm-prog"> 138 166 <primary sortas="b-nasm">nasm</primary> … … 144 172 <term><command>ndisasm</command></term> 145 173 <listitem> 146 <para>is an 80x86 binary file disassembler.</para> 174 <para> 175 is an 80x86 binary file disassembler. 176 </para> 147 177 <indexterm zone="nasm ndisasm"> 148 178 <primary sortas="b-ndisasm">ndisasm</primary> -
general/prog/openjdk.xml
r5ab87cfa rde33b2a 121 121 </listitem> 122 122 <listitem> 123 <para>Estimated disk space required: &ojdk-bdsize;</para> 123 <para> 124 Estimated disk space required: &ojdk-bdsize; 125 </para> 124 126 </listitem> 125 127 <listitem> 126 <para>Estimated build time: &ojdk-time;</para> 128 <para> 129 Estimated build time: &ojdk-time; 130 </para> 127 131 </listitem> 128 132 </itemizedlist> … … 267 271 unset JT_JAVA</userinput></screen> 268 272 269 <para>For more control over the test suite, review the documentation 270 available in <filename>jtreg/doc/jtreg/usage.txt</filename>. To review the 271 results, see the files 272 <filename>JTreport/test_{jdk,langtools}/text/stats.txt</filename> and 273 <filename>JTreport/test_{jdk,langtools}/text/summary.txt</filename>. 274 You should expect to see around 40 failures and a couple of errors.</para> 273 <para> 274 For more control over the test suite, review the documentation 275 available in <filename>jtreg/doc/jtreg/usage.txt</filename>. To review 276 the results, see the files 277 <filename>JTreport/test_{jdk,langtools}/text/stats.txt</filename> and 278 <filename>JTreport/test_{jdk,langtools}/text/summary.txt</filename>. 279 You should expect to see around 40 failures and a couple of errors. 280 </para> 275 281 <!-- 11.0.2+9: 276 282 for x86_64: 2 Errors, 28 Failures … … 280 286 for i686: PENDING --> 281 287 282 <para>Install the package with the following commands as the 283 <systemitem class="username">root</systemitem> user:</para> 288 <para> 289 Install the package with the following commands as the 290 <systemitem class="username">root</systemitem> user: 291 </para> 284 292 285 293 <screen role="root"><userinput>install -vdm755 /opt/jdk-&openjdk-version;+&openjdk-build; && … … 510 518 <?dbfo list-presentation="list"?> 511 519 <?dbhtml list-presentation="table"?> 512 <!-- 513 <varlistentry id="appletviewer"> 514 <term><command>appletviewer</command></term> 515 <listitem> 516 <para>allows to run applets outside of a web browser.</para> 517 <indexterm zone="openjdk appletviewer"> 518 <primary sortas="b-appletviewer">appletviewer</primary> 519 </indexterm> 520 </listitem> 521 </varlistentry> 522 523 <varlistentry id="idlj"> 524 <term><command>idlj</command></term> 525 <listitem> 526 <para>generates Java bindings from a given IDL file.</para> 527 <indexterm zone="openjdk idlj"> 528 <primary sortas="b-idlj">idlj</primary> 529 </indexterm> 530 </listitem> 531 </varlistentry> 532 --> 520 533 521 <varlistentry id="jaotc"> 534 522 <term><command>jaotc</command></term> 535 523 <listitem> 536 <para>is an <quote>ahead-of-time</quote> java class compiler.</para> 524 <para> 525 is an <quote>ahead-of-time</quote> java class compiler. 526 </para> 537 527 <indexterm zone="openjdk jaotc"> 538 528 <primary sortas="b-jaotc">jaotc</primary> … … 544 534 <term><command>jar</command></term> 545 535 <listitem> 546 <para>combines multiple files into a single jar archive.</para> 536 <para> 537 combines multiple files into a single jar archive. 538 </para> 547 539 <indexterm zone="openjdk jar"> 548 540 <primary sortas="b-jar">jar</primary> … … 554 546 <term><command>jarsigner</command></term> 555 547 <listitem> 556 <para>signs jar files and verifies the signatures and integrity 557 of a signed jar file.</para> 548 <para> 549 signs jar files and verifies the signatures and integrity 550 of a signed jar file. 551 </para> 558 552 <indexterm zone="openjdk jarsigner"> 559 553 <primary sortas="b-jarsigner">jarsigner</primary> … … 565 559 <term><command>java</command></term> 566 560 <listitem> 567 <para>launches a Java application by starting a Java runtime 568 environment, loading a specified class and invoking its main 569 method.</para> 561 <para> 562 launches a Java application by starting a Java runtime 563 environment, loading a specified class and invoking its main 564 method. 565 </para> 570 566 <indexterm zone="openjdk java-prog"> 571 567 <primary sortas="b-java-prog">java</primary> … … 577 573 <term><command>javac</command></term> 578 574 <listitem> 579 <para>reads class and interface definitions, written in the 580 Java programming language, and compiles them into bytecode 581 class files.</para> 575 <para> 576 reads class and interface definitions, written in the 577 Java programming language, and compiles them into bytecode 578 class files. 579 </para> 582 580 <indexterm zone="openjdk javac"> 583 581 <primary sortas="b-javac">javac</primary> … … 589 587 <term><command>javadoc</command></term> 590 588 <listitem> 591 <para>parses the declarations and documentation comments in a 592 set of Java source files and produces a corresponding set of 593 HTML pages describing the classes, interfaces, constructors, 594 methods, and fields.</para> 589 <para> 590 parses the declarations and documentation comments in a 591 set of Java source files and produces a corresponding set of 592 HTML pages describing the classes, interfaces, constructors, 593 methods, and fields. 594 </para> 595 595 <indexterm zone="openjdk javadoc"> 596 596 <primary sortas="b-javadoc">javadoc</primary> … … 602 602 <term><command>javap</command></term> 603 603 <listitem> 604 <para>disassembles a Java class file.</para> 604 <para> 605 disassembles a Java class file. 606 </para> 605 607 <indexterm zone="openjdk javap"> 606 608 <primary sortas="b-javap">javap</primary> … … 612 614 <term><command>jcmd</command></term> 613 615 <listitem> 614 <para>is a utility to send diagnostic command requests to a running 615 Java Virtual Machine.</para> 616 <para> 617 is a utility to send diagnostic command requests to a running 618 Java Virtual Machine. 619 </para> 616 620 <indexterm zone="openjdk jcmd"> 617 621 <primary sortas="b-jcmd">jcmd</primary> … … 623 627 <term><command>jconsole</command></term> 624 628 <listitem> 625 <para>is a graphical console tool to monitor and manage both 626 local and remote Java applications and virtual machines.</para> 629 <para> 630 is a graphical console tool to monitor and manage both 631 local and remote Java applications and virtual machines. 632 </para> 627 633 <indexterm zone="openjdk jconsole"> 628 634 <primary sortas="b-jconsole">jconsole</primary> … … 634 640 <term><command>jdb</command></term> 635 641 <listitem> 636 <para>is a simple command-line debugger for Java classes.</para> 642 <para> 643 is a simple command-line debugger for Java classes. 644 </para> 637 645 <indexterm zone="openjdk jdb"> 638 646 <primary sortas="b-jdb">jdb</primary> … … 644 652 <term><command>jdeprscan</command></term> 645 653 <listitem> 646 <para>scans class or jar files for uses of deprecated API 647 elements.</para> 654 <para> 655 scans class or jar files for uses of deprecated API elements. 656 </para> 648 657 <indexterm zone="openjdk jdeprscan"> 649 658 <primary sortas="b-jdeprscan">jdeprscan</primary> … … 655 664 <term><command>jdeps</command></term> 656 665 <listitem> 657 <para>shows the package-level or class-level dependencies of 658 Java class files.</para> 666 <para> 667 shows the package-level or class-level dependencies of 668 Java class files. 669 </para> 659 670 <indexterm zone="openjdk jdeps"> 660 671 <primary sortas="b-jdeps">jdeps</primary> … … 666 677 <term><command>jhsdb</command></term> 667 678 <listitem> 668 <para>is a tool to analyze the content of a core dump from a 669 crashed Java Virtual Machine (JVM).</para> 679 <para> 680 is a tool to analyze the content of a core dump from a 681 crashed Java Virtual Machine (JVM). 682 </para> 670 683 <indexterm zone="openjdk jhsdb"> 671 684 <primary sortas="b-jhsdb">jhsdb</primary> … … 677 690 <term><command>jimage</command></term> 678 691 <listitem> 679 <para>is used to list, extract, verify, or get information about 680 modules in <emphasis>jimage</emphasis> format.</para> 692 <para> 693 is used to list, extract, verify, or get information about 694 modules in <emphasis>jimage</emphasis> format. 695 </para> 681 696 <indexterm zone="openjdk jimage"> 682 697 <primary sortas="b-jimage">jimage</primary> … … 688 703 <term><command>jinfo</command></term> 689 704 <listitem> 690 <para>prints Java configuration information for a given Java 691 process, core file, or a remote debug server.</para> 705 <para> 706 prints Java configuration information for a given Java 707 process, core file, or a remote debug server. 708 </para> 692 709 <indexterm zone="openjdk jinfo"> 693 710 <primary sortas="b-jinfo">jinfo</primary> … … 699 716 <term><command>jjs</command></term> 700 717 <listitem> 701 <para>is a command-line tool used to invoke the Nashorn engine. It 702 can be used to interpret one or several script files, or to run 703 an interactive shell.</para> 718 <para> 719 is a command-line tool used to invoke the Nashorn engine. It 720 can be used to interpret one or several script files, or to run 721 an interactive shell. 722 </para> 704 723 <indexterm zone="openjdk jjs"> 705 724 <primary sortas="b-jjs">jjs</primary> … … 711 730 <term><command>jlink</command></term> 712 731 <listitem> 713 <para>is used to assemble and optimize a set of modules and their 714 dependencies into a custom runtime image.</para> 732 <para> 733 is used to assemble and optimize a set of modules and their 734 dependencies into a custom runtime image. 735 </para> 715 736 <indexterm zone="openjdk jlink"> 716 737 <primary sortas="b-jlink">jlink</primary> … … 722 743 <term><command>jmap</command></term> 723 744 <listitem> 724 <para>prints shared object memory maps or heap memory details 725 of a given process, core file, or a remote debug server.</para> 745 <para> 746 prints shared object memory maps or heap memory details 747 of a given process, core file, or a remote debug server. 748 </para> 726 749 <indexterm zone="openjdk jmap"> 727 750 <primary sortas="b-jmap">jmap</primary> … … 733 756 <term><command>jmod</command></term> 734 757 <listitem> 735 <para>creates JMOD files and lists the content of existing JMOD 736 files.</para> 758 <para> 759 creates JMOD files and lists the content of existing JMOD files. 760 </para> 737 761 <indexterm zone="openjdk jmod"> 738 762 <primary sortas="b-jmod">jmod</primary> … … 744 768 <term><command>jps</command></term> 745 769 <listitem> 746 <para>lists the instrumented JVMs on the target system.</para> 770 <para> 771 lists the instrumented JVMs on the target system. 772 </para> 747 773 <indexterm zone="openjdk jps"> 748 774 <primary sortas="b-jps">jps</primary> … … 754 780 <term><command>jrunscript</command></term> 755 781 <listitem> 756 <para>is a command line script shell.</para> 782 <para> 783 is a command line script shell. 784 </para> 757 785 <indexterm zone="openjdk jrunscript"> 758 786 <primary sortas="b-jrunscript">jrunscript</primary> … … 764 792 <term><command>jshell</command></term> 765 793 <listitem> 766 <para>is an interactive tool for learning the Java programming 767 language and prototyping Java code.</para> 794 <para> 795 is an interactive tool for learning the Java programming 796 language and prototyping Java code. 797 </para> 768 798 <indexterm zone="openjdk jshell"> 769 799 <primary sortas="b-jshell">jshell</primary> … … 775 805 <term><command>jstack</command></term> 776 806 <listitem> 777 <para>prints Java stack traces of Java threads for a given 778 Java process, core file, or a remote debug server.</para> 807 <para> 808 prints Java stack traces of Java threads for a given 809 Java process, core file, or a remote debug server. 810 </para> 779 811 <indexterm zone="openjdk jstack"> 780 812 <primary sortas="b-jstack">jstack</primary> … … 786 818 <term><command>jstat</command></term> 787 819 <listitem> 788 <para>displays performance statistics for an instrumented JVM.</para> 820 <para> 821 displays performance statistics for an instrumented JVM. 822 </para> 789 823 <indexterm zone="openjdk jstat"> 790 824 <primary sortas="b-jstat">jstat</primary> … … 796 830 <term><command>jstatd</command></term> 797 831 <listitem> 798 <para>is an RMI server application that monitors for the creation 799 and termination of instrumented JVMs.</para> 832 <para> 833 is an RMI server application that monitors for the creation 834 and termination of instrumented JVMs. 835 </para> 800 836 <indexterm zone="openjdk jstatd"> 801 837 <primary sortas="b-jstatd">jstatd</primary> … … 807 843 <term><command>keytool</command></term> 808 844 <listitem> 809 <para>is a key and certificate management utility.</para> 845 <para> 846 is a key and certificate management utility. 847 </para> 810 848 <indexterm zone="openjdk keytool"> 811 849 <primary sortas="b-keytool">keytool</primary> … … 813 851 </listitem> 814 852 </varlistentry> 815 <!-- 816 <varlistentry id="orbd"> 817 <term><command>orbd</command></term> 818 <listitem> 819 <para>is used to enable clients to transparently locate and invoke 820 persistent objects on servers in the CORBA environment.</para> 821 <indexterm zone="openjdk orbd"> 822 <primary sortas="b-orbd">orbd</primary> 823 </indexterm> 824 </listitem> 825 </varlistentry> 826 --> 853 827 854 <varlistentry id="pack200"> 828 855 <term><command>pack200</command></term> 829 856 <listitem> 830 <para>is a Java application that transforms a jar file into a 831 compressed pack200 file using the Java gzip compressor.</para> 857 <para> 858 is a Java application that transforms a jar file into a 859 compressed pack200 file using the Java gzip compressor. 860 </para> 832 861 <indexterm zone="openjdk pack200"> 833 862 <primary sortas="b-pack200">pack200</primary> … … 839 868 <term><command>rmic</command></term> 840 869 <listitem> 841 <para>generates stub and skeleton class files for remote objects 842 from the names of compiled Java classes that contain remote 843 object implementations.</para> 870 <para> 871 generates stub and skeleton class files for remote objects 872 from the names of compiled Java classes that contain remote 873 object implementations. 874 </para> 844 875 <indexterm zone="openjdk rmic"> 845 876 <primary sortas="b-rmic">rmic</primary> … … 851 882 <term><command>rmid</command></term> 852 883 <listitem> 853 <para>starts the activation system daemon.</para> 884 <para> 885 starts the activation system daemon. 886 </para> 854 887 <indexterm zone="openjdk rmid"> 855 888 <primary sortas="b-rmid">rmid</primary> … … 861 894 <term><command>rmiregistry</command></term> 862 895 <listitem> 863 <para>creates and starts a remote object registry on the specified 864 port on the current host.</para> 896 <para> 897 creates and starts a remote object registry on the specified 898 port on the current host. 899 </para> 865 900 <indexterm zone="openjdk rmiregistry"> 866 901 <primary sortas="b-rmiregistry">rmiregistry</primary> … … 868 903 </listitem> 869 904 </varlistentry> 870 <!-- 871 <varlistentry id="schemagen"> 872 <term><command>schemagen</command></term> 873 <listitem> 874 <para>is a Java XML binding schema generator.</para> 875 <indexterm zone="openjdk schemagen"> 876 <primary sortas="b-schemagen">schemagen</primary> 877 </indexterm> 878 </listitem> 879 </varlistentry> 880 --> 905 881 906 <varlistentry id="serialver"> 882 907 <term><command>serialver</command></term> 883 908 <listitem> 884 <para>returns the serialVersionUID for one or more classes in a 885 form suitable for copying into an evolving class.</para> 909 <para> 910 returns the serialVersionUID for one or more classes in a 911 form suitable for copying into an evolving class. 912 </para> 886 913 <indexterm zone="openjdk serialver"> 887 914 <primary sortas="b-serialver">serialver</primary> … … 889 916 </listitem> 890 917 </varlistentry> 891 <!-- 892 <varlistentry id="servertool"> 893 <term><command>servertool</command></term> 894 <listitem> 895 <para>provides an ease-of-use interface for application programmers 896 to register, unregister, startup and shutdown a server.</para> 897 <indexterm zone="openjdk servertool"> 898 <primary sortas="b-servertool">servertool</primary> 899 </indexterm> 900 </listitem> 901 </varlistentry> 902 903 <varlistentry id="tnameserv"> 904 <term><command>tnameserv</command></term> 905 <listitem> 906 <para>starts the Java IDL name server.</para> 907 <indexterm zone="openjdk tnameserv"> 908 <primary sortas="b-tnameserv">tnameserv</primary> 909 </indexterm> 910 </listitem> 911 </varlistentry> 912 --> 918 913 919 <varlistentry id="unpack200"> 914 920 <term><command>unpack200</command></term> 915 921 <listitem> 916 <para>is a native implementation that transforms a packed file 917 produced by <application>pack200</application> into a jar 918 file.</para> 922 <para> 923 is a native implementation that transforms a packed file 924 produced by <application>pack200</application> into a jar 925 file. 926 </para> 919 927 <indexterm zone="openjdk unpack200"> 920 928 <primary sortas="b-unpack200">unpack200</primary> … … 922 930 </listitem> 923 931 </varlistentry> 924 <!-- 925 <varlistentry id="wsgen"> 926 <term><command>wsgen</command></term> 927 <listitem> 928 <para>generates JAX-WS portable artifacts used in JAX-WS 929 web services.</para> 930 <indexterm zone="openjdk wsgen"> 931 <primary sortas="b-wsgen">wsgen</primary> 932 </indexterm> 933 </listitem> 934 </varlistentry> 935 936 <varlistentry id="wsimport"> 937 <term><command>wsimport</command></term> 938 <listitem> 939 <para>generates JAX-WS portable artifacts.</para> 940 <indexterm zone="openjdk wsimport"> 941 <primary sortas="b-wsimport">wsimport</primary> 942 </indexterm> 943 </listitem> 944 </varlistentry> 945 946 <varlistentry id="xjc"> 947 <term><command>xjc</command></term> 948 <listitem> 949 <para>is a Java XML binding compiler.</para> 950 <indexterm zone="openjdk xjc"> 951 <primary sortas="b-xjc">xjc</primary> 952 </indexterm> 953 </listitem> 954 </varlistentry> 955 --> 932 956 933 </variablelist> 957 934 -
general/prog/perl-deps/perl-file-find-rule.xml
r5ab87cfa rde33b2a 82 82 <term><command>findrule</command></term> 83 83 <listitem> 84 <para>is a command line wrapper to File::Find::Rule.</para> 84 <para> 85 is a command line wrapper to File::Find::Rule. 86 </para> 85 87 <indexterm zone="perl-file-find-rule findrule-prog"> 86 88 <primary sortas="b-findrule">findrule</primary> -
general/prog/perl-deps/perl-libwww-perl.xml
r5ab87cfa rde33b2a 32 32 </para> 33 33 34 <!-- F Or CPAN, this may be pulled in with 'cpan -i Bundle::LWP' -->34 <!-- For CPAN, this may be pulled in with 'cpan -i Bundle::LWP' --> 35 35 36 36 &lfs91_checked; … … 84 84 85 85 <para> 86 After installing this package, if you want HTTPS protocol support install87 <xref linkend="perl-lwp-protocol-https"/>.86 After installing this package, if you want HTTPS protocol support 87 install <xref linkend="perl-lwp-protocol-https"/>. 88 88 </para> 89 89 … … 111 111 <term><command>lwp-download</command></term> 112 112 <listitem> 113 <para>is a script to fetch a large file from the web.</para> 113 <para> 114 is a script to fetch a large file from the web. 115 </para> 114 116 <!-- the -prog is for while (old) and new- perl module pages 115 117 are both in the book, without it the link to the package is … … 125 127 <term><command>lwp-dump</command></term> 126 128 <listitem> 127 <para>is used to see what headers and content is returned 128 for a URL.</para> 129 <para> 130 is used to see what headers and content is returned for a URL. 131 </para> 129 132 <indexterm zone="perl-libwww-perl lwp-dump-prog"> 130 133 <primary sortas="b-lwp-dump">lwp-dump</primary> … … 136 139 <term><command>lwp-mirror</command></term> 137 140 <listitem> 138 <para>is a simple mirror utility.</para> 141 <para> 142 is a simple mirror utility. 143 </para> 139 144 <indexterm zone="perl-libwww-perl lwp-mirror-prog"> 140 145 <primary sortas="b-lwp-mirror">lwp-mirror</primary> … … 146 151 <term><command>lwp-request</command></term> 147 152 <listitem> 148 <para>is a simple command line user agent.</para> 153 <para> 154 is a simple command line user agent. 155 </para> 149 156 <indexterm zone="perl-libwww-perl lwp-request-prog"> 150 157 <primary sortas="b-lwp-request">lwp-request</primary> -
general/prog/perl-modules/perl-archive-zip.xml
r5ab87cfa rde33b2a 85 85 <term><command>crc32</command></term> 86 86 <listitem> 87 <para>computes and prints to stdout the CRC-32 values of the given files.</para> 87 <para> 88 computes and prints to stdout the CRC-32 values of the given 89 files. 90 </para> 88 91 <indexterm zone="perl-archive-zip crc32-prog"> 89 92 <primary sortas="b-crc32">crc32</primary> -
general/prog/perl-modules/perl-lingua-translit.xml
r5ab87cfa rde33b2a 74 74 <term><command>translit</command></term> 75 75 <listitem> 76 <para>transliterates text between writing systems using 77 various standards.</para> 76 <para> 77 transliterates text between writing systems using various 78 standards. 79 </para> 78 80 <indexterm zone="perl-lingua-translit translit-prog"> 79 81 <primary sortas="b-translit">translit</primary> -
general/prog/perl-modules/perl-log-log4perl.xml
r5ab87cfa rde33b2a 74 74 <term><command>l4p-templ</command></term> 75 75 <listitem> 76 <para>prints out the text of a template Log4perl configuration for 77 starting a new Log4perl configuration file.</para> 76 <para> 77 prints out the text of a template Log4perl configuration for 78 starting a new Log4perl configuration file. 79 </para> 78 80 <indexterm zone="perl-log-log4perl l4p-templ-prog"> 79 81 <primary sortas="b-l4p-templ">l4p-templ</primary> -
general/prog/perl-modules/perl-parse-yapp.xml
r5ab87cfa rde33b2a 75 75 <term><command>yapp</command></term> 76 76 <listitem> 77 <para>is a frontend to the Parse::Yapp module, which lets you create 78 a Perl OO parser from an input grammar file.</para> 77 <para> 78 is a frontend to the Parse::Yapp module, which lets you create 79 a Perl OO parser from an input grammar file. 80 </para> 79 81 <indexterm zone="perl-parse-yapp yapp-prog"> 80 82 <primary sortas="b-yapp">yapp</primary> -
general/prog/perl-modules/perl-text-bibtex.xml
r5ab87cfa rde33b2a 87 87 <term><command>biblex</command></term> 88 88 <listitem> 89 <para>performs lexical analysis on a BibTeX file.</para> 89 <para> 90 performs lexical analysis on a BibTeX file. 91 </para> 90 92 <indexterm zone="perl-text-bibtex biblex-prog"> 91 93 <primary sortas="b-biblex">biblex</primary> … … 97 99 <term><command>bibparse</command></term> 98 100 <listitem> 99 <para>parses a series of BibTeX files with command line options to 100 control the string post-processing behaviour.</para> 101 <para> 102 parses a series of BibTeX files with command line options to 103 control the string post-processing behaviour. 104 </para> 101 105 <indexterm zone="perl-text-bibtex bibparse-prog"> 102 106 <primary sortas="b-bibparse">bibparse</primary> … … 108 112 <term><command>dumpnames</command></term> 109 113 <listitem> 110 <para>parses a BibTeX file, splitting 'author' and 'editor' fields 111 into lists of names, and then dumps everything to stdout.</para> 114 <para> 115 parses a BibTeX file, splitting 'author' and 'editor' fields 116 into lists of names, and then dumps everything to stdout. 117 </para> 112 118 <indexterm zone="perl-text-bibtex dumpnames-prog"> 113 119 <primary sortas="b-dumpnames">dumpnames</primary> … … 119 125 <term><filename class='libraryfile'>libbtparse.so</filename></term> 120 126 <listitem> 121 <para>is a library for parsing and processing BibTeX data files.</para> 127 <para> 128 is a library for parsing and processing BibTeX data files. 129 </para> 122 130 <indexterm zone="perl-text-bibtex libbtparse-lib"> 123 131 <primary sortas="c-libbtparse">libbtparse.so</primary> -
general/prog/prog.xml
r5ab87cfa rde33b2a 16 16 <title>Programming</title> 17 17 18 <para>A base LFS system can be used as a development 19 platform, however the base system only includes language support for 20 <application>C</application>, <application>C++</application> and 21 <application>Perl</application>. This chapter provides instructions to 22 build many popular programming environments to greatly expand your 23 system's development capabilities.</para> 18 <para> 19 A base LFS system can be used as a development 20 platform, however the base system only includes language support for 21 <application>C</application>, <application>C++</application> and 22 <application>Perl</application>. This chapter provides instructions to 23 build many popular programming environments to greatly expand your 24 system's development capabilities. 25 </para> 24 26 25 27 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="autoconf213.xml"/> 26 28 <!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="bazaar.xml"/> --> 27 29 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="cbindgen.xml"/> 28 <!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="check.xml"/> -->29 30 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="clisp.xml"/> 30 31 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="cmake.xml"/> 31 <!--<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="cvs.xml"/>32 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="cvsserver.xml"/>-->33 32 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dejagnu.xml"/> 34 33 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="doxygen.xml"/> 35 <!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="elfutils.xml"/> -->36 34 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="expect.xml"/> 37 35 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gcc.xml"/> 38 <!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gcc-java.xml"/>-->39 36 <!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gcc-ada.xml"/> --> 40 37 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gc.xml"/> … … 48 45 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="mercurial.xml"/> 49 46 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nasm.xml"/> 50 <!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="ninja.xml"/>51 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="npapi-sdk.xml"/> -->52 47 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="perl-modules.xml"/> 53 48 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="perl-deps.xml"/> -
general/prog/python2.xml
r5ab87cfa rde33b2a 48 48 </para> 49 49 50 <para> 50 <para> 51 51 BLFS is attempting to use Python3 as much as possible, but some 52 52 packages have not been updated to support Python3. -
general/prog/python3.xml
r5ab87cfa rde33b2a 44 44 </para> 45 45 46 <note><para><application>Python 3</application> was installed in LFS. 47 The only reason to rebuild it here is if optional modules 48 are needed.</para></note> 46 <note> 47 <para> 48 <application>Python 3</application> was installed in LFS. 49 The only reason to rebuild it here is if optional modules 50 are needed. 51 </para> 52 </note> 49 53 50 54 &lfs91_checked; -
general/prog/rust.xml
r5ab87cfa rde33b2a 470 470 If you installed <application>rustc</application> in 471 471 <filename class="directory">/opt</filename>, you need to update the 472 following configuration files so that <application>rustc</application> is473 correctly found by other packages and system processes.472 following configuration files so that <application>rustc</application> 473 is correctly found by other packages and system processes. 474 474 </para> 475 475 … … 507 507 EOF</userinput></screen> 508 508 509 <para>Immediately after installation, update the current PATH 510 for your current shell as a normal user:</para> 509 <para> 510 Immediately after installation, update the current PATH 511 for your current shell as a normal user: 512 </para> 511 513 512 514 <screen><userinput>source /etc/profile.d/rustc.sh</userinput></screen> -
general/prog/slang.xml
r5ab87cfa rde33b2a 30 30 <title>Introduction to slang</title> 31 31 32 <para><application>S-Lang</application> (slang) is an interpreted language 33 that may be embedded into an application to make the application 34 extensible. It provides facilities required by interactive applications 35 such as display/screen management, keyboard input and keymaps.</para> 32 <para> 33 <application>S-Lang</application> (slang) is an interpreted language 34 that may be embedded into an application to make the application 35 extensible. It provides facilities required by interactive applications 36 such as display/screen management, keyboard input and keymaps. 37 </para> 36 38 37 39 &lfs91_checked; … … 40 42 <itemizedlist spacing="compact"> 41 43 <listitem> 42 <para>Download (HTTP): <ulink url="&slang-download-http;"/></para> 43 </listitem> 44 <listitem> 45 <para>Download (FTP): <ulink url="&slang-download-ftp;"/></para> 46 </listitem> 47 <listitem> 48 <para>Download MD5 sum: &slang-md5sum;</para> 49 </listitem> 50 <listitem> 51 <para>Download size: &slang-size;</para> 52 </listitem> 53 <listitem> 54 <para>Estimated disk space required: &slang-buildsize;</para> 55 </listitem> 56 <listitem> 57 <para>Estimated build time: &slang-time;</para> 44 <para> 45 Download (HTTP): <ulink url="&slang-download-http;"/></para> 46 </listitem> 47 <listitem> 48 <para> 49 Download (FTP): <ulink url="&slang-download-ftp;"/></para> 50 </listitem> 51 <listitem> 52 <para> 53 Download MD5 sum: &slang-md5sum;</para> 54 </listitem> 55 <listitem> 56 <para> 57 Download size: &slang-size;</para> 58 </listitem> 59 <listitem> 60 <para> 61 Estimated disk space required: &slang-buildsize;</para> 62 </listitem> 63 <listitem> 64 <para> 65 Estimated build time: &slang-time;</para> 58 66 </listitem> 59 67 </itemizedlist> … … 82 90 </note> 83 91 84 <para>Install <application>slang</application> by running the following 85 commands:</para> 92 <para> 93 Install <application>slang</application> by running the following 94 commands: 95 </para> 86 96 87 97 <screen><userinput>./configure --prefix=/usr \ … … 90 100 make -j1</userinput></screen> 91 101 92 <para>To test the results, issue: <command>make check</command>. Note that 93 this will also create a static version of the library which will then be 94 installed in the next step.</para> 95 96 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 102 <para> 103 To test the results, issue: <command>make check</command>. Note that 104 this will also create a static version of the library which will then be 105 installed in the next step. 106 </para> 107 108 <para> 109 Now, as the <systemitem class="username">root</systemitem> user: 110 </para> 97 111 98 112 <screen role='root'><userinput>make install_doc_dir=/usr/share/doc/slang-&slang-version; \ … … 113 127 </para> 114 128 115 <para><command>make install_doc_dir=/usr/share/doc/slang-&slang-version; 116 SLSH_DOC_DIR=/usr/share/doc/slang-&slang-version;/slsh install-all</command>: 117 This command installs the static library as well as 118 the dynamic shared version and related modules. It also changes the 119 documentation installation directories to a versioned directory.</para> 129 <para> 130 <command>make install_doc_dir=/usr/share/doc/slang-&slang-version; 131 SLSH_DOC_DIR=/usr/share/doc/slang-&slang-version;/slsh install-all</command>: 132 This command installs the static library as well as 133 the dynamic shared version and related modules. It also changes the 134 documentation installation directories to a versioned directory. 135 </para> 120 136 121 137 </sect2> … … 126 142 <sect3 id="slang-config"> 127 143 <title>Config Files</title> 128 <para><filename>~/.slshrc</filename> and 129 <filename>/etc/slsh.rc</filename></para> 144 <para> 145 <filename>~/.slshrc</filename> and 146 <filename>/etc/slsh.rc</filename> 147 </para> 130 148 131 149 <indexterm zone="slang slang-config"> … … 164 182 <term><command>slsh</command></term> 165 183 <listitem> 166 <para>is a simple program for interpreting 167 <application>slang</application> scripts. It supports dynamic loading 168 of <application>slang</application> modules and includes a 169 <application>Readline</application> interface for interactive 170 use.</para> 184 <para> 185 is a simple program for interpreting 186 <application>slang</application> scripts. It supports dynamic 187 loading of <application>slang</application> modules and includes a 188 <application>Readline</application> interface for interactive use. 189 </para> 171 190 <indexterm zone="slang slsh"> 172 191 <primary sortas="b-slsh">slsh</primary> -
general/prog/svnserver.xml
r5ab87cfa rde33b2a 19 19 <title>Running a Subversion Server</title> 20 20 21 <para>This section will describe how to set up, administer and secure 22 a <application>Subversion</application> server.</para> 21 <para> 22 This section will describe how to set up, administer and secure 23 a <application>Subversion</application> server. 24 </para> 23 25 24 26 <bridgehead renderas="sect3">Subversion Server Dependencies</bridgehead> 25 27 26 28 <bridgehead renderas="sect4">Required</bridgehead> 27 <para><xref linkend="subversion"/> and 28 <xref linkend="openssh"/></para> 29 <para role="required"> 30 <xref linkend="subversion"/> and 31 <xref linkend="openssh"/> 32 </para> 29 33 30 34 </sect2> … … 33 37 <title>Setting up a Subversion Server.</title> 34 38 35 <para>The following instructions will install a 36 <application>Subversion</application> server, which will be set up 37 to use <application>OpenSSH</application> as the secure remote access 38 method, with <command>svnserve</command> available for anonymous 39 access.</para> 40 41 <para>Configuration of the <application>Subversion</application> server 42 consists of the following steps:</para> 39 <para> 40 The following instructions will install a 41 <application>Subversion</application> server, which will be set up 42 to use <application>OpenSSH</application> as the secure remote access 43 method, with <command>svnserve</command> available for anonymous 44 access. 45 </para> 46 47 <para> 48 Configuration of the <application>Subversion</application> server 49 consists of the following steps: 50 </para> 43 51 44 52 <sect3> 45 53 <title>1. Setup Users, Groups, and Permissions</title> 46 54 47 <para>You'll need to be user 48 <systemitem class='username'>root</systemitem> for the initial portion of 49 configuration. Create the <systemitem class="username">svn</systemitem> 50 user and group with the following commands:</para> 55 <para> 56 You'll need to be user 57 <systemitem class='username'>root</systemitem> for the initial portion 58 of configuration. Create the <systemitem 59 class="username">svn</systemitem> user and group with the following 60 commands: 61 </para> 51 62 52 63 <screen role="root"><userinput>groupadd -g 56 svn && 53 64 useradd -c "SVN Owner" -d /home/svn -m -g svn -s /bin/false -u 56 svn</userinput></screen> 54 65 55 <para>If you plan to have multiple repositories, you should have a 56 group dedicated to each repository for ease of administration. Create 57 the <systemitem class="groupname">svntest</systemitem> group for the test 58 repository and add the <systemitem class="username">svn</systemitem> 59 user to that group with the following commands:</para> 66 <para> 67 If you plan to have multiple repositories, you should have a 68 group dedicated to each repository for ease of administration. Create 69 the <systemitem class="groupname">svntest</systemitem> group for the 70 test repository and add the <systemitem 71 class="username">svn</systemitem> user to that group with the 72 following commands: 73 </para> 60 74 61 75 <screen role="root"><userinput>groupadd -g 57 svntest && 62 76 usermod -G svntest -a svn</userinput></screen> 63 77 64 <para>Additionally you should set <command>umask 002</command> while 65 working with a repository so that all new files will be writable by 66 owner and group. This is made mandatory by creating a wrapper script for 67 <command>svn</command> and <command>svnserve</command>:</para> 78 <para> 79 Additionally you should set <command>umask 002</command> while 80 working with a repository so that all new files will be writable by 81 owner and group. This is made mandatory by creating a wrapper script 82 for <command>svn</command> and <command>svnserve</command>: 83 </para> 68 84 69 85 <screen role="root"><userinput>mv /usr/bin/svn /usr/bin/svn.orig && … … 82 98 83 99 <note> 84 <para>If you use <application>Apache</application> for working with 85 the repository over HTTP, even for anonymous access, you should wrap 86 <command>/usr/sbin/httpd</command> in a similar script.</para> 100 <para> 101 If you use <application>Apache</application> for working with 102 the repository over HTTP, even for anonymous access, you should wrap 103 <command>/usr/sbin/httpd</command> in a similar script. 104 </para> 87 105 </note> 88 106 … … 110 128 svnadmin create /srv/svn/repositories/svntest</userinput></screen> 111 129 112 <para>Now that the repository is created, it should be populated with 113 something useful. You'll need to have a predefined directory 114 layout set up exactly as you want your repository to look. For 115 example, here is a sample BLFS layout setup with a root of 116 <filename>svntest/</filename>. You'll need to setup a directory 117 tree similar to the following:</para> 130 <para> 131 Now that the repository is created, it should be populated with 132 something useful. You'll need to have a predefined directory 133 layout set up exactly as you want your repository to look. For 134 example, here is a sample BLFS layout setup with a root of 135 <filename>svntest/</filename>. You'll need to setup a directory 136 tree similar to the following: 137 </para> 118 138 119 139 <screen><literal>svntest/ # The name of the repository … … 127 147 tags/ # Needed for tagging release points</literal></screen> 128 148 129 <para>Once you've created your directory layout as shown above, you 130 are ready to do the initial import:</para> 149 <para> 150 Once you've created your directory layout as shown above, you 151 are ready to do the initial import: 152 </para> 131 153 132 154 <screen role="root"><userinput>svn import -m "Initial import." \ … … 134 156 file:///srv/svn/repositories/svntest</userinput></screen> 135 157 136 <para>Now change owner and group information on the 137 repository, and add an unprivileged user to the 138 <systemitem class="groupname">svn</systemitem> and 139 <systemitem class="groupname">svntest</systemitem> groups:</para> 158 <para> 159 Now change owner and group information on the 160 repository, and add an unprivileged user to the 161 <systemitem class="groupname">svn</systemitem> and 162 <systemitem class="groupname">svntest</systemitem> groups: 163 </para> 140 164 141 165 <screen role="root"><userinput>chown -R svn:svntest /srv/svn/repositories/svntest && … … 144 168 usermod -G svn,svntest -a <replaceable><username></replaceable></userinput></screen> 145 169 146 <para><systemitem class="groupname">svntest</systemitem> is the group 147 assigned to the svntest repository. As mentioned earlier, this eases 148 administration of multiple repositories when using 149 <application>OpenSSH</application> for authentication. Going forward, 150 you'll need to add your unprivileged user, and any additional users that 151 you wish to have write access to the repository, to the 152 <systemitem class="groupname">svn</systemitem> and 153 <systemitem class="groupname">svntest</systemitem> groups.</para> 154 155 <para>In addition, you'll notice that the new repository's 156 <filename>db</filename> directory is set-groupID. If the reasoning is 157 not immediately obvious, when using any external authentication method 158 (such as <command>ssh</command>), the sticky bit is set so that all 159 new files will be owned by the user, but group of 160 <systemitem class="groupname">svntest</systemitem>. Anyone in the 161 <systemitem class="groupname">svntest</systemitem> group can create 162 files, but still give the entire group write access to those 163 files. This avoids locking out other users from the repository.</para> 164 165 <para>Now, return to an unprivileged user account, and take a 166 look at the new repository using <command>svnlook</command>:</para> 170 <para> 171 <systemitem class="groupname">svntest</systemitem> is the group 172 assigned to the svntest repository. As mentioned earlier, this eases 173 administration of multiple repositories when using 174 <application>OpenSSH</application> for authentication. Going forward, 175 you'll need to add your unprivileged user, and any additional users 176 that you wish to have write access to the repository, to the 177 <systemitem class="groupname">svn</systemitem> and <systemitem 178 class="groupname">svntest</systemitem> groups. 179 </para> 180 181 <para> 182 In addition, you'll notice that the new repository's 183 <filename>db</filename> directory is set-groupID. If the reasoning is 184 not immediately obvious, when using any external authentication method 185 (such as <command>ssh</command>), the sticky bit is set so that all 186 new files will be owned by the user, but group of 187 <systemitem class="groupname">svntest</systemitem>. Anyone in the 188 <systemitem class="groupname">svntest</systemitem> group can create 189 files, but still give the entire group write access to those 190 files. This avoids locking out other users from the repository. 191 </para> 192 193 <para> 194 Now, return to an unprivileged user account, and take a 195 look at the new repository using <command>svnlook</command>: 196 </para> 167 197 168 198 <screen><userinput>svnlook tree /srv/svn/repositories/svntest/</userinput></screen> 169 199 170 200 <note> 171 <para>You may need to log out and back in again to refresh your group 172 memberships. '<command>su <replaceable><username></replaceable></command>' 173 should work as well.</para> 201 <para> 202 You may need to log out and back in again to refresh your group 203 memberships. <command>su 204 <replaceable><username></replaceable></command> 205 should work as well. 206 </para> 174 207 </note> 175 208 … … 179 212 <title>3. Configure the Server</title> 180 213 181 <para>As mentioned previously, these instructions will configure the 182 server to use only <command>ssh</command> for write access to the 183 repository and to provide anonymous access using 184 <command>svnserve</command>. There are several other ways to provide 185 access to the repository. These additional configurations are best 186 explained at <ulink url="http://svnbook.red-bean.com/"/>.</para> 187 188 <para>Access configuration needs to be done for each repository. 189 Create the <filename>svnserve.conf</filename> file for the svntest 190 repository using the following commands:</para> 214 <para> 215 As mentioned previously, these instructions will configure the 216 server to use only <command>ssh</command> for write access to the 217 repository and to provide anonymous access using 218 <command>svnserve</command>. There are several other ways to provide 219 access to the repository. These additional configurations are best 220 explained at <ulink url="http://svnbook.red-bean.com/"/>. 221 </para> 222 223 <para> 224 Access configuration needs to be done for each repository. 225 Create the <filename>svnserve.conf</filename> file for the svntest 226 repository using the following commands: 227 </para> 191 228 192 229 <screen role="root"><userinput>cp /srv/svn/repositories/svntest/conf/svnserve.conf \ … … 199 236 EOF</userinput></screen> 200 237 201 <para>There is not a lot to the configuration file at all. You'll 202 notice that only the general section is required. Take a look at the 203 <filename>svnserve.conf.default</filename> file for information on using 204 <command>svnserve</command>'s built-in authentication method.</para> 238 <para> 239 There is not a lot to the configuration file at all. You'll notice 240 that only the general section is required. Take a look at the 241 <filename>svnserve.conf.default</filename> file for information on 242 using <command>svnserve</command>'s built-in authentication method. 243 </para> 205 244 206 245 </sect3> … … 209 248 <title>4. Starting the Server</title> 210 249 211 <para revision="sysv">To start the server at boot time, install the svn 212 bootscript included in the <xref linkend="bootscripts"/> package.</para> 213 214 <para revision="systemd">To start the server at boot time, install the 215 <filename>svnserve.service</filename> unit from the 216 <xref linkend="systemd-units"/> package.</para> 250 <para revision="sysv"> 251 To start the server at boot time, install the svn 252 bootscript included in the <xref linkend="bootscripts"/> package: 253 </para> 254 255 <para revision="systemd"> 256 To start the server at boot time, install the 257 <filename>svnserve.service</filename> unit from the 258 <xref linkend="systemd-units"/> package: 259 </para> 217 260 218 261 <indexterm zone="svnserver svnserver-init" revision="sysv"> … … 228 271 <screen role="root" revision="systemd"><userinput>make install-svnserve</userinput></screen> 229 272 230 <para revision="systemd">Additionally, the instructions above require 231 that svn server uses <command>umask 002</command> so that all new files 232 will be writable by owner and group. This can be achieved by creating 233 a systemd unit override file by running the following command:</para> 273 <para revision="systemd"> 274 Additionally, the instructions above require 275 that svn server uses <command>umask 002</command> so that all new files 276 will be writable by owner and group. This can be achieved by creating 277 a systemd unit override file by running the following command: 278 </para> 234 279 235 280 <screen role="root" revision="systemd"><userinput>mkdir -p /etc/systemd/system/svnserve.service.d 236 281 echo "UMask=0002" > /etc/systemd/system/svnserve.service.d/99-user.conf</userinput></screen> 237 282 238 <para revision="systemd">Options which are passed to 239 <command>svnserve</command> daemon can be changed in 240 <filename>/etc/default/svnserve</filename>.</para> 283 <para revision="systemd"> 284 Options which are passed to 285 <command>svnserve</command> daemon can be changed in 286 <filename>/etc/default/svnserve</filename>. 287 </para> 241 288 242 289 </sect3> -
general/prog/vala.xml
r5ab87cfa rde33b2a 112 112 <title>Installation of Vala</title> 113 113 114 <para>Install <application>Vala</application> by running the following 115 commands:</para> 116 <!-- 117 <note> 118 <para>If the recommended dependency <xref linkend="graphviz"/> is not 119 installed, apply a patch. This will prevent building the valadoc program 120 and libraries that can be used to generate API documentation in HTML format 121 from Vala source code. 122 </para> 123 124 <screen><userinput>patch -p1 -i ../vala-&vala-version;-avoid_graphviz-1.patch && 125 ACLOCAL= autoreconf -fiv</userinput></screen> 126 </note> 127 --> 114 <para> 115 Install <application>Vala</application> by running the following 116 commands: 117 </para> 118 128 119 <screen><userinput>./configure --prefix=/usr && 129 120 make</userinput></screen> … … 221 212 </varlistentry> 222 213 223 <!--224 <varlistentry id="vapicheck">225 <term><command>vapicheck</command></term>226 <listitem>227 <para>228 verifies the generated bindings.229 </para>230 <indexterm zone="vala vapicheck">231 <primary sortas="b-vapicheck">vapicheck</primary>232 </indexterm>233 </listitem>234 </varlistentry>-->235 236 214 <varlistentry id="vapigen"> 237 215 <term><command>vapigen</command></term> -
general/prog/yasm.xml
r5ab87cfa rde33b2a 30 30 <title>Introduction to yasm</title> 31 31 32 <para><application>Yasm</application> is a complete rewrite of the 33 <xref linkend="nasm"/> assembler. It supports the x86 and AMD64 instruction 34 sets, accepts NASM and GAS assembler syntaxes and outputs binary, ELF32 and 35 ELF64 object formats.</para> 32 <para> 33 <application>Yasm</application> is a complete rewrite of the 34 <xref linkend="nasm"/> assembler. It supports the x86 and AMD64 35 instruction sets, accepts NASM and GAS assembler syntaxes and outputs 36 binary, ELF32 and ELF64 object formats. 37 </para> 36 38 37 39 &lfs91_checked; … … 40 42 <itemizedlist spacing="compact"> 41 43 <listitem> 42 <para>Download (HTTP): <ulink url="&yasm-download-http;"/></para> 44 <para> 45 Download (HTTP): <ulink url="&yasm-download-http;"/> 46 </para> 43 47 </listitem> 44 48 <listitem> 45 <para>Download (FTP): <ulink url="&yasm-download-ftp;"/></para> 49 <para> 50 Download (FTP): <ulink url="&yasm-download-ftp;"/> 51 </para> 46 52 </listitem> 47 53 <listitem> 48 <para>Download MD5 sum: &yasm-md5sum;</para> 54 <para> 55 Download MD5 sum: &yasm-md5sum; 56 </para> 49 57 </listitem> 50 58 <listitem> 51 <para>Download size: &yasm-size;</para> 59 <para> 60 Download size: &yasm-size; 61 </para> 52 62 </listitem> 53 63 <listitem> 54 <para>Estimated disk space required: &yasm-buildsize;</para> 64 <para> 65 Estimated disk space required: &yasm-buildsize; 66 </para> 55 67 </listitem> 56 68 <listitem> 57 <para>Estimated build time: &yasm-time;</para> 69 <para> 70 Estimated build time: &yasm-time; 71 </para> 58 72 </listitem> 59 73 </itemizedlist> … … 75 89 <title>Installation of yasm</title> 76 90 77 <para>Install <application>yasm</application> by running the following 78 commands:</para> 91 <para> 92 Install <application>yasm</application> by running the following 93 commands: 94 </para> 79 95 80 96 <screen><userinput>sed -i 's#) ytasm.*#)#' Makefile.in && … … 83 99 make</userinput></screen> 84 100 85 <para>To test the results, issue: <command>make check</command>.</para> 101 <para> 102 To test the results, issue: <command>make check</command>. 103 </para> 86 104 87 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 105 <para> 106 Now, as the <systemitem class="username">root</systemitem> user: 107 </para> 88 108 89 109 <screen role="root"><userinput>make install</userinput></screen> … … 94 114 <title>Command Explanations</title> 95 115 96 <para><command>sed -i 's#) ytasm.*#)#' Makefile.in</command>: This sed 97 prevents it compiling 2 programs (vsyasm and ytasm) that are only of use 98 on Microsoft Windows.</para> 116 <para> 117 <command>sed -i 's#) ytasm.*#)#' Makefile.in</command>: This sed 118 prevents it compiling 2 programs (vsyasm and ytasm) that are only of use 119 on Microsoft Windows. 120 </para> 99 121 100 122 </sect2> … … 123 145 <term><command>yasm</command></term> 124 146 <listitem> 125 <para>is a portable, retargetable assembler that supports the x86 and 126 AMD64 instruction sets, accepts NASM and GAS assembler syntaxes and 127 outputs binaries in ELF32 and ELF64 object formats.</para> 147 <para> 148 is a portable, retargetable assembler that supports the x86 and 149 AMD64 instruction sets, accepts NASM and GAS assembler syntaxes and 150 outputs binaries in ELF32 and ELF64 object formats. 151 </para> 128 152 <indexterm zone="yasm yasm"> 129 153 <primary sortas="b-yasm">yasm</primary> … … 135 159 <term><filename class='libraryfile'>libyasm.a</filename></term> 136 160 <listitem> 137 <para>provides all of the core functionality of 138 <command>yasm</command>, for manipulating machine instructions and 139 object file constructs.</para> 161 <para> 162 provides all of the core functionality of <command>yasm</command>, 163 for manipulating machine instructions and object file constructs. 164 </para> 140 165 <indexterm zone="yasm libyasm"> 141 166 <primary sortas="c-libyasm">libyasm.a</primary>
Note:
See TracChangeset
for help on using the changeset viewer.