[Cdk-commits] CVS: cdk/doc/RFC 10.xml,NONE,1.1 9.xml,NONE,1.1

[Egon W. <eg...@us...>]

Update of /cvsroot/cdk/cdk/doc/RFC
In directory sc8-pr-cvs1:/tmp/cvs-serv4483/RFC

Added Files:
	10.xml 9.xml 
Log Message:
Added RFC 9 and 10.


--- NEW FILE: 10.xml ---
<refentry id="cdk-rfc-10">

  <refentryinfo>
    <revhistory>
      <revision>
        <revnumber>1</revnumber>
        <date>2002-11-28</date>
        <authorinitials>elw</authorinitials>
        <revremark>
          See <ulink url="">email archive</ulink>.
        </revremark>
      </revision>
    </revhistory>
  </refentryinfo>


  <refnamediv>
    <refname>RFC CDK #10</refname>
  </refnamediv>

  <refsect1>
    <title>Proposal</title>
    <para>
The addition of two fields with get and set methods for storage of the 
covalent and vanderwaals radii for the atom type. 
    </para>
  </refsect1>

  <refsect1>
    <title>Reason</title>
    <para>
This is needed to move port Jmol to CDK.
    </para>
  </refsect1>

</refentry>

--- NEW FILE: 9.xml ---
<refentry id="cdk-rfc-9">

  <refentryinfo>
    <revhistory>
      <revision>
        <revnumber>1</revnumber>
        <date>2002-11-26</date>
        <authorinitials>elw</authorinitials>
        <revremark>
          See <ulink url="">email archive</ulink>.
        </revremark>
      </revision>
    </revhistory>
  </refentryinfo>


  <refnamediv>
    <refname>RFC CDK #9</refname>
  </refnamediv>

  <refsect1>
    <title>Proposal</title>
    <para>The .toString() methods of the core classes give information about the content 
of the class. My proposal is that the resulting String of these methods is a 
String without \n and \r chars (thus a one-liner) that gives an overview of 
the class. Being a one-liner, the output can be used in Log4J debugging 
output, without having the problem that lines in the output become 
multilined.
</para>
    <para>Note that I assume that the toString() method is not to be used for formating 
the atom's properties, but just for quick developers access to its contents.</para>
  </refsect1>

  <refsect1>
    <title>Reason</title>
    <para>At this moment the Log4J output is complicated by multilined debug lines like:
<programlisting>
2002-11-26 15:11:58,883 [main] DEBUG org.openscience.cdk.applications.Viewer - 
0. Atom Hg
Hydrogen count: 0
Stereo Parity: 0
2D coordinates: (0.0021, -0.0041)
3D coordinates: (0.0021, -0.0041, 0.0020)
Partial charge: 0.0
Formal charge: 0
</programlisting>
    A simple "grep -v applications.Viewer" now no longer removes all output from 
the applications.Viewer class. If the atom.toString() output would be 
one-lined, filtering could be done much easier.
</para>
  </refsect1>

</refentry>