Changeset 6fe6db6 for general


Ignore:
Timestamp:
12/15/2014 03:13:32 PM (9 years ago)
Author:
Pierre Labastie <pieere@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 7.10, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, nosym, perl-modules, 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:
7f5413b
Parents:
75b189d4
Message:

Fix errors in javadoc for Junit and FOP+reformat

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@15207 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • general/prog/junit.xml

    r75b189d4 r6fe6db6  
    3030    <title>Introduction to JUnit</title>
    3131
    32     <para>The <application>JUnit</application> package contains a simple, open
    33     source framework to write and run repeatable tests. It is an instance of
    34     the xUnit architecture for unit testing frameworks. JUnit features include
    35     assertions for testing expected results, test fixtures for sharing common
    36     test data, and test runners for running tests.</para>
     32    <para>
     33      The <application>JUnit</application> package contains a simple, open
     34      source framework to write and run repeatable tests. It is an instance of
     35      the xUnit architecture for unit testing frameworks. JUnit features include
     36      assertions for testing expected results, test fixtures for sharing common
     37      test data, and test runners for running tests.
     38    </para>
    3739
    3840    &lfs76_checked;
    … …  
    8789    <title>Installation of JUnit</title>
    8890
    89 <!--    <para>To do a full build of JUnit from source, <xref linkend='apache-ant'/>
    90     is required.  However JUnit is useful in building Apache Ant.  Copy the
    91     JUnit-&junit-version; jar file to get started.  Then come back to build
    92     from source, if desired.</para>
     91    <para>
     92      The <command>javadoc</command> command coming with OpenJDK 8 has become
     93      much stricter than before regarding the conformance of the Javadoc
     94      comments in source code to HTML. The <application>Junit</application>
     95      documentation does not meet those standard, so the conformance checks
     96      have to be disabled. This can be done with the following command:
     97    </para>
    9398
    94     <para>Install the <application>JUnit</application> jar file by running the following
    95     commands as the <systemitem class="username">root</systemitem> user:</para>
     99<screen><userinput>sed -i '\@/docs/@a&lt;arg value="Xdoclint:none"/&gt;' build.xml</userinput></screen>
    96100
    97 <screen role="root"><userinput>install -v -m755 -d /usr/share/java &amp;&amp;
    98 cp -v junit-&junit-version;.jar /usr/share/java</userinput></screen>
    99 
    100     <para>At this point, make sure Apache-Ant is installed and then continue
    101     with the source build and installation.  From the directory created when
    102     extracting the JUnit sources, place the required hamcrest jar files where
    103     needed and build the package:</para>
    104 -->
    105     <para>Place the required hamcrest jar files where needed and build the
    106     package:</para>
     101    <para>
     102      Now place the required hamcrest jar files where needed and build the
     103      package:
     104    </para>
    107105
    108106<screen><userinput>tar -xf ../hamcrest-&hamcrest-version;.tgz                              &amp;&amp;
    109107cp -v hamcrest-&hamcrest-version;/hamcrest-core-&hamcrest-version;{,-sources}.jar lib/ &amp;&amp;
    110 ant dist</userinput></screen>
     108ant populate-dist</userinput></screen>
    111109
    112     <para>Testing is automatically done as a part of the build step.</para>
     110    <para>
     111      Test the package by issuing <command>ant dist</command>. One test fails
     112      for unknown reason.
     113    </para>
    113114
    114     <para>Install the files in the final location as the
    115     <systemitem class="username">root</systemitem> user:</para>
     115    <para>
     116      Install the files in the final location as the
     117      <systemitem class="username">root</systemitem> user:
     118    </para>
    116119   
    117120<screen role="root"><userinput>install -v -m755 -d /usr/share/{doc,java}/junit-&junit-version; &amp;&amp;
    … …  
    122125cp -v hamcrest-&hamcrest-version;/hamcrest-core*.jar /usr/share/java/junit-&junit-version;</userinput></screen>
    123126   
    124     <para>Finally, update the <envar>CLASSPATH</envar> variable:</para>
     127    <para>
     128      Finally, update the <envar>CLASSPATH</envar> variable:
     129    </para>
    125130
    126131<screen><userinput>export CLASSPATH=$CLASSPATH:/usr/share/java/junit-&junit-version;</userinput></screen>
    … …  
    132137    <segmentedlist>
    133138      <segtitle>Installed Programs</segtitle>
    134       <segtitle>Installed Libraies</segtitle>
     139      <segtitle>Installed Libraries</segtitle>
    135140      <segtitle>Installed Directories</segtitle>
    136141
Note: See TracChangeset for help on using the changeset viewer.