AW: AW: [Jsynthlib-devel] AW: Eclipse: Indentation / Displayed tab width

[Joachim B. <jba...@pi...>]

Hi,

I rewrote the text a bit and softened the "use ..." with=20
a prefixed "please".

I hope it's better now. :-)

By the way: I would like to change from "first person" to
"third person" or specify the author for the corresponding text =
passages.

E.g. the reader doesn't know who wrote the following:
"I wrote a significant part of the JSynthLib core code using EDIT.COM =
which comes with Windows. More recently, I've switched to jEdit, a Java =
based emacs-like programmer's editor with syntax highlighting and =
bracket matching."

And this is a little bit like recommending EDIT.COM which
in my eyes is not a good idea (it doesn't support the tab settings,
has no synthax highlighting, etc.).

And last but not least I suggest to add the "last modified" date
after the headline,
e.g.

<h1>JSynthLib Programmer's Guide</h1>
<p>Last modified:  $Date$</p>

This example uses the date which is generated by CVS when a checkin is =
made.

Regards,
Joachim Backhaus



> -----Urspr=FCngliche Nachricht-----
> Von: jsy...@li...
> [mailto:jsy...@li...]Im=20
> Auftrag von Hiroo
> Hayashi
> Gesendet: Donnerstag, 3. Februar 2005 07:31
> An: jsy...@li...
> Betreff: Re: AW: [Jsynthlib-devel] AW: Eclipse: Indentation /=20
> Displayed
> tab width
>=20
>=20
> Hi,
>=20
> Joachim> Please have a look at the changes whether they are OK.
>=20
> Basically I agree with you.
>=20
> You replaced
>=20
> original> Preferred indentation level is 4.
>=20
> by follows;
>=20
> new> <p><strong>Important:</strong> Use an indentation level of 4=20
>=20
> This is stronger than before.  I hesitated to force synth driver
> developers the indentation level.  I did not change indentation of
> synth drivers except for Kawai K4.  I did it for Kawai K4 with Brian's
> approval, because it is a reference driver.
>=20
> I'd like to hear the comments from others.
>=20
> new> and a "tab stop"/ "displayed tab width" value of 8.<br>=20
> new> The reason for this is compatibility with:</p>
> new>=20
> new> <ul>
> new>   <li>... Emacs in Java mode which replaces 8 blank=20
> spaces to 1 tab if possible.</li>
> new>   <li>... Unix command line tools like cat, less, tail, ...</li>
> new>   <li>... viewcvs, the CVS browser that SourceForge uses.</li>
> new> </ul>
>=20
> Emacs is extremely flexible and has no problem for any style.  Instead
> of that, "notepad" for Windows is another good example.
>=20
> The point is that there are many widely used tools which supports only
> displayed tab width 8.  We have no choice here on a group project like
> JSynthlib project.  And it is the default setting even for tools which
> can change the setting.  (I forgot the default setting of Eclipse.  It
> might be an exception.) We can just say "don't change the default
> setting."
>=20
> new> The JSynthLib team recommends the use of <a
> new> href=3D"#setupEclipse">Eclipse</a> which is able to support this
> new> settings.<br>=20
>=20
> Do we?  I personally strongly recommend Eclipse, but I don't want to
> do it as the JSynthLib team.  I'd like to let developers to use any
> tool he likes.
>=20
> I believe there is no tool which cannot set the display tab=20
> width to 8.
>=20
> new> Text editors that also support these settings are
> new> e.g. <a href=3D"http://www.jedit.org/">jEdit</a> and <a
> new> href=3D"http://scintilla.sourceforge.net/SciTE.html">SciTE</a>
> new> which are both open source and availabe for Linux, Mac OS X and
> new> Windows like Eclipse.
>=20
> I don't think we need this info here.  Let's put this on the section
> "What do I need in order to add support for a new synthesizer?"
>=20
> And seeing the balance of whole this chapter, it may be better to move
> the part starting "The reason for this is ..." to FAQ chapter and to
> make a link to it from here.
>=20
> --=20
> Hiroo Hayashi
>=20
>=20
>=20
> -------------------------------------------------------
> This SF.Net email is sponsored by: IntelliVIEW -- Interactive=20
> Reporting
> Tool for open source databases. Create drag-&-drop reports. Save time
> by over 75%! Publish reports on the web. Export to DOC, XLS, RTF, etc.
> Download a FREE copy at http://www.intelliview.com/go/osdn_nl
> _______________________________________________
> Jsynthlib-devel mailing list
> Jsy...@li...
> https://lists.sourceforge.net/lists/listinfo/jsynthlib-devel
>=20