Re: documentation?

2001-05-05 Thread Aaron Trevena

On Sat, 5 May 2001, Aaron Trevena wrote:

> just curious where the peeps who were going to do some more documentation
> have got to.. any news? urls? agendas?

Its ok - I'll reply to myself... :) its a saturday and it sunny outside
but dial up is chaper weekends than weekdays sooo..
 
> I am just working on a guide to creating, parsing and manipulating Dia's
> XML format - if you are very very lucky I might even do an annotated
> version of the DTD, but don't hold your breath and somebody who created it
> or works with it more than me might be better at it. Anybody who knows teh
> DTD or is involved in how Dia mucks about with its XML can you conact me
> on or off list?

pH33R my '13et Go0gL3 5k1Llz!!

back in november Bryan J. Smith posted this to a different list that I may
have to slurp into Mail::Audit for data mining later:
http://www.matrixlist.com/pipermail/leaplist/2000-November/007909.html

included in his mail is this url about GNOME/Dia and XML.
http://linux.inrialpes.fr/veillard/XML/xml.html

also check out

http://togaware.com/linuxbook/dia.pdf - the dia chapter from toga's linux
book

and

our very own James' page on xml-sax giving you agood idea on Dia does its
XML.

http://www.daa.com.au/~james/gnome/xml-sax/xml-sax.html

anybody now if these urls are less relevent than they seem. anyways I'll
use them as a starting point for my k-rad guide to doing bad voodoo with
Dia's xml.

cheers,

A. (TheBlueJackal on Freshmeat, Mojo Jojo on any unreal tournament server)

-- 
.sig is currently undergoing engineering works, please change at
 piccadilly circus.





documentation?

2001-05-05 Thread Aaron Trevena


just curious where the peeps who were going to do some more documentation
have got to.. any news? urls? agendas?

I am just working on a guide to creating, parsing and manipulating Dia's
XML format - if you are very very lucky I might even do an annotated
version of the DTD, but don't hold your breath and somebody who created it
or works with it more than me might be better at it. Anybody who knows teh
DTD or is involved in how Dia mucks about with its XML can you conact me
on or off list?

The guide will consist mostly of recycled AutoDIAL
(http://www.droogs.org/autodial/) code and documentation although I'm
reading up on various bits of Dia so expect to see some of the FAQ in
there and some pointers to IBM deverloperworks research papers on using
xml and perl. Also the tutorial will be perl oriented because thats how I
parse XML because nothing else has teh sheer power and versatility of
perl.

Anybody interested in contributing to it please respond on or off list. in
case you're wondering several friends have asked me to explain how to do
some stuff with Dia XML and rather than work out their problems I'm just
doing this guide to keep them off my back *grin*.

regards,

A.

P.S.


AutoDIAL is now at version 0.04, it finds some attributes and most methods
and handles most perl code. version 0.05 will be mostly optimisations and
bug fixes (although nobody has sent me any bugs on it yet) and will the
beta before I release version 1.0. from there I plan to add support for
multiple languages and also provide a way of choosing whether to output to
dia or graphviz.


--

.sig is currently undergoing engineering works, please change at
piccadilly circus.




Re: dia documentation

2001-03-26 Thread Steffen Macke

> if you are building out of CVS (and even then, it may compile and install
> okay without docs (haven't tested this though)).

It does for me (With the not-so-nice HTML).

Steffen

_
Do You Yahoo!?
Get your free @yahoo.com address at http://mail.yahoo.com





Re: dia documentation

2001-03-26 Thread James Henstridge

On Mon, 26 Mar 2001, Steffen Macke wrote:

> Hi,
>
> I'm having problems building the dia documentation:
> * The note/tip icons don't show up in the HTML.
> * The screenshot images have the extension *.gif in the HTML instead of *.png
>
> Could this problem be related to a wrong stylesheet?

Yes.  Docs written by the GDP use a variant of Docbook that allows PNG
images (this was done as a temporary measure until an updated DTD is
released that could use PNGs).  It can be grabbed from the GDP website
(somewhere on http://developer.gnome.org/).

I don't know about the first problem though.  Note that an HTML version of
the docs will be included in the tarball, so db2html will only be required
if you are building out of CVS (and even then, it may compile and install
okay without docs (haven't tested this though)).

James.




dia documentation

2001-03-25 Thread Steffen Macke

Hi,

I'm having problems building the dia documentation:
* The note/tip icons don't show up in the HTML.
* The screenshot images have the extension *.gif in the HTML instead of *.png

Could this problem be related to a wrong stylesheet?

Steffen

_
Do You Yahoo!?
Get your free @yahoo.com address at http://mail.yahoo.com





Re: documentation effort

2001-03-21 Thread James Henstridge

On Wed, 21 Mar 2001, Scott Harrison wrote:

> Looks like we have a team based on the four responses.
> (Thank you Gustavo, James, Harry, Aaron, and Ben.)
> 
> And, YES, this is NOT user documentation.  This
> is developer documentation.
> 
> Dia documentation should (of course) use markup.
> I guess there are two things needed for quick development:
> * code needs internal documentation notes which can be
>   parsed into graphical/textual documentation
> * graphical documentation should be not be just read-only;
>   alterations to graphical/textual documentation should seamlessly
>   pass back into the code
[snip]

To get some immediately useful documentation, it may be better to look at
documenting things relating to specific tasks rather than deciding to
document everything (this was my "what documentation to people 
want?" question).  Some stuff is probably better to not document too
much, as it is subject to change, but other stuff stays more constant.

Here are some tasks people may want to do (and the parts of dia they
would need to know about for that):
  - How do I write a new object type for dia?
 - knowledge of dia object system and how to create new objects
 - overview of properties interface
 - dia rendering model
 - info on load/save
  - I want to do something with the XML files dia creates, or write new
files for dia to read
 - Info on the basic layout of dia files (dtd, etc)
 - common attributes of objects
 - maybe more detailed info on specific objects
  - I want to write a .shape file
 - This is mostly taken care of in the doc/custom-shapes file.

There are probably other interesting tasks.  Documenting something that
ism't of interest or is likely to change from version to version is
probably not the best use of your time.

James.

-- 
Email: [EMAIL PROTECTED]
WWW:   http://www.daa.com.au/~james/





documentation effort

2001-03-21 Thread Scott Harrison

Looks like we have a team based on the four responses.
(Thank you Gustavo, James, Harry, Aaron, and Ben.)

And, YES, this is NOT user documentation.  This
is developer documentation.

Dia documentation should (of course) use markup.
I guess there are two things needed for quick development:
* code needs internal documentation notes which can be
  parsed into graphical/textual documentation
* graphical documentation should be not be just read-only;
  alterations to graphical/textual documentation should seamlessly
  pass back into the code

Basically, some people need to be doing top-->down
(graphical into internal code comments) and others need to
go bottom-->up (internal code comments into graphical).

Here are some initial questions.

* What is dia? (System-view documentation)
  Summary information of the 1825 files in my dia tree directory
  and their interrelationships.
  (I volunteer to do this since wrapping and burning
   application/system specifications is what I often do.)
* What tool(s) should be used?
  Dia-UML primarily of course.
  Others mentioned were gtk-doc and doxygen.  The docbook sgml stuff
  looks good, and since Gustavo swears by it, let's probably move
  in that path?  I like what it does with templates.
* What pieces of code should we comment up, work up first?
  Here is a line-of-code listing of some of the code pieces:
   1078 ./objects/custom/shape_info.c
   1109 ./app/layer_dialog.c
   1114 ./lib/beziershape.c
   1115 ./objects/UML/association.c
   1117 ./app/interface.c
   1185 ./lib/properties.c
   1205 ./objects/UML/class.c
   1206 ./app/render_eps.c
   1209 ./plug-ins/wpg/wpg.c
   1280 ./plug-ins/cgm/cgm.c
   1379 ./objects/custom/custom_object.c
   1459 ./plug-ins/xfig/xfig-import.c
   1615 ./app/render_libart.c
   2694 ./objects/UML/class_dialog.c  

I will set up a read-write CVS server and web page by
the end of the week for the four of you to use, as
well as anonymous access.

James, I'm a newbie, so feel free to provide better
guidance to any of this.

Everybody else, I'm a newbie, so feel free to laugh
or something. :)

-Scott




Re: OPEN REQUEST FOR RESURRECTING DOCUMENTATION

2001-03-21 Thread Gustavo João Alves Marques Carneiro

On Tue, 20 Mar 2001, Scott Harrison wrote:

> Fine with me.  Nice set of pages you have there.  So I guess the next
> big
> question is,
> 
> WHO WANTS TO HELP DOCUMENT THINGS?

  I'd love to help if you're referring to devel docs. May I suggest the
use of gtk-doc? I've recently learned how to use it and I love it. I
should warn though that I don't know the internals of Dia code, but would
love to, and so will be asking lots of questions.

> 
> If volunteers send me ([EMAIL PROTECTED]) their e-mail addresses,
> we can begin to set up a new effort at documentation.  As soon (within
> a week) as there is some reasonable understanding as to how to proceed,
> we can begin communicating through dia-list as to what is going on.
> 
> I do offer my site as a mirror site for dia to support redundancy.
> 
> -Scott
> 
> Hubert Figuiere wrote:
> > 
> > Scott Harrison écrit:
> > 
> > > I have a stable machine on a gigabyte network.  I enjoy documentation
> > > AND am good at it, typically using XML (via Python).
> > > I love Dia.  I am developing a number of things with Dia.  Any chance
> > > I could host the documentation?  Is there access to the original
> > > software documentation? Should we start from scratch?
> > 
> > Perhaps Doxygen (http://www.doxygen.org/) could be used as it allow to write
> > code and doc at the same time ?
> > 
> > Hub
> 
> 

-- 
Gustavo J. A. M. Carneiro
[http://linuxdeec.fe.up.pt/~ee96090]




Re: OPEN REQUEST FOR RESURRECTING DOCUMENTATION

2001-03-20 Thread James Henstridge

On Tue, 20 Mar 2001, Scott Harrison wrote:

> Fine with me.  Nice set of pages you have there.  So I guess the next
> big
> question is,
>
> WHO WANTS TO HELP DOCUMENT THINGS?
>
> If volunteers send me ([EMAIL PROTECTED]) their e-mail addresses,
> we can begin to set up a new effort at documentation.  As soon (within
> a week) as there is some reasonable understanding as to how to proceed,
> we can begin communicating through dia-list as to what is going on.
>
> I do offer my site as a mirror site for dia to support redundancy.

Are you talking about user documentation or developer documentation?  Note
that we now have user documentation (one of the great new features of dia
0.87, provided by the GNOME documentation project).  This is being
distributed with the application.  If you want to contribute to this
documentation, contact the GDP.

There is not much developer documentation at present however.  What sort
of info do you want?

James.




Re: Re: OPEN REQUEST FOR RESURRECTING DOCUMENTATION

2001-03-20 Thread Harry George

I'm interested in documentation, but know nothing about the internals
(yet).  Longer term I want to be able to use Dia functionality
inother programs, esp. called from python, and that requires better
understanding of the internals and the modularization.

On Tue, 20 Mar 2001, Ben A. Hetland wrote:
> Date: Tue, 20 Mar 2001 20:51:01 +0100
> To: [EMAIL PROTECTED], [EMAIL PROTECTED]
> From: "Ben A. Hetland" <[EMAIL PROTECTED]>
> Reply-To: [EMAIL PROTECTED]
> Subject: Re: OPEN REQUEST FOR RESURRECTING DOCUMENTATION
> 
> 
> Scott Harrison wrote:
> > 
> > Fine with me.  Nice set of pages you have there.  So I guess the
> next
> > big
> > question is,
> > 
> > WHO WANTS TO HELP DOCUMENT THINGS?
> > 
> > If volunteers send me ([EMAIL PROTECTED]) their e-mail addresses,
> 
> Well, I kinda already volunteered, so I'd like to contribute...
> although for the next month or so my first priority will be what is
> needed solely for my [payed] project.
> 
> 
> > we can begin to set up a new effort at documentation.  As soon
> (within
> > a week) as there is some reasonable understanding as to how to
> proceed,
> > we can begin communicating through dia-list as to what is going
> on.
> 
> However, please note that the purpose of my original question was
> to
> locate
> documentation & ideas that were already "there somewhere"... and to
> avoid the
> more tedious (and time-consuming) task of reverse-engineering.
> 
> (Yes, I know that we programmer's tend to be sloppy about
> documenting
> for
> others what we make... gotta have some trade secrets... ;-)
> 
> 
> 
> > 
> > Hubert Figuiere wrote:
> [...snip...]
> > >
> > > Perhaps Doxygen (http://www.doxygen.org/) could be used as it
> allow to write
> > > code and doc at the same time ?
> 
> That's an idea. But besides that, Doxygen might (?) have a problem
> identifying
> the classes buried in the Dia design, since after all it's C not
> C++ or
> Java...
> 
> In my view, one of the problems with such automated tools to
> "resurrect
> and/or
> reverse engineer" existing code is that they're too accurate --
> they
> include
> all the details and any patological interdependencies that might
> have
> grown
> into the source over the years, thereby obscuring the basic ideas &
> structure.
> (It cannot distinguish between important and unimportant design
> features,
> ending up showing just a lot of "noise".)
> 
> IMHO, merely converting code comments into HTML/RTF/whatever
> doesn't
> improve
> _that_ much over just reading the source files directly... It
> doesn't
> always
> reveal the structure.
> 
> But that's just me, though... :-)
> 
> 
> Actually, I made a very tiny start using Dia itself (why not!?!!)
> and
> the UML
> elements, creating a class diagram based on header files and the
> README
> file.
> ...until I found that this was very time-consuming since I had not
> gained any
> familiarity with the source beforehand.
> 
> 
> -+-Ben-+-
> 
> 
> 
-- 
Harry George
[EMAIL PROTECTED]




Re: OPEN REQUEST FOR RESURRECTING DOCUMENTATION

2001-03-20 Thread Ben A. Hetland


Scott Harrison wrote:
> 
> Fine with me.  Nice set of pages you have there.  So I guess the next
> big
> question is,
> 
> WHO WANTS TO HELP DOCUMENT THINGS?
> 
> If volunteers send me ([EMAIL PROTECTED]) their e-mail addresses,

Well, I kinda already volunteered, so I'd like to contribute...
although for the next month or so my first priority will be what is
needed solely for my [payed] project.


> we can begin to set up a new effort at documentation.  As soon (within
> a week) as there is some reasonable understanding as to how to proceed,
> we can begin communicating through dia-list as to what is going on.

However, please note that the purpose of my original question was to
locate
documentation & ideas that were already "there somewhere"... and to
avoid the
more tedious (and time-consuming) task of reverse-engineering.

(Yes, I know that we programmer's tend to be sloppy about documenting
for
others what we make... gotta have some trade secrets... ;-)



> 
> Hubert Figuiere wrote:
[...snip...]
> >
> > Perhaps Doxygen (http://www.doxygen.org/) could be used as it allow to write
> > code and doc at the same time ?

That's an idea. But besides that, Doxygen might (?) have a problem
identifying
the classes buried in the Dia design, since after all it's C not C++ or
Java...

In my view, one of the problems with such automated tools to "resurrect
and/or
reverse engineer" existing code is that they're too accurate -- they
include
all the details and any patological interdependencies that might have
grown
into the source over the years, thereby obscuring the basic ideas &
structure.
(It cannot distinguish between important and unimportant design
features,
ending up showing just a lot of "noise".)

IMHO, merely converting code comments into HTML/RTF/whatever doesn't
improve
_that_ much over just reading the source files directly... It doesn't
always
reveal the structure.

But that's just me, though... :-)


Actually, I made a very tiny start using Dia itself (why not!?!!) and
the UML
elements, creating a class diagram based on header files and the README
file.
...until I found that this was very time-consuming since I had not
gained any
familiarity with the source beforehand.


-+-Ben-+-




Re: OPEN REQUEST FOR RESURRECTING DOCUMENTATION

2001-03-20 Thread Aaron Trevena

On Tue, 20 Mar 2001, Scott Harrison wrote:

> Fine with me.  Nice set of pages you have there.  So I guess the next
> big
> question is,
> 
> WHO WANTS TO HELP DOCUMENT THINGS?

I'm more interested in the xml side - ie creating tools to work with the
xml or plugins to work with dia. I'd be able to provide a little about the
xml from my own reverse engineering hopefully one of the dev team can
provide more info (DTD isn't documentation enough).

A.




OPEN REQUEST FOR RESURRECTING DOCUMENTATION

2001-03-20 Thread Scott Harrison

Fine with me.  Nice set of pages you have there.  So I guess the next
big
question is,

WHO WANTS TO HELP DOCUMENT THINGS?

If volunteers send me ([EMAIL PROTECTED]) their e-mail addresses,
we can begin to set up a new effort at documentation.  As soon (within
a week) as there is some reasonable understanding as to how to proceed,
we can begin communicating through dia-list as to what is going on.

I do offer my site as a mirror site for dia to support redundancy.

-Scott

Hubert Figuiere wrote:
> 
> Scott Harrison écrit:
> 
> > I have a stable machine on a gigabyte network.  I enjoy documentation
> > AND am good at it, typically using XML (via Python).
> > I love Dia.  I am developing a number of things with Dia.  Any chance
> > I could host the documentation?  Is there access to the original
> > software documentation? Should we start from scratch?
> 
> Perhaps Doxygen (http://www.doxygen.org/) could be used as it allow to write
> code and doc at the same time ?
> 
> Hub




Re: Source Documentation

2001-03-20 Thread Hubert Figuiere

Scott Harrison écrit:

> I have a stable machine on a gigabyte network.  I enjoy documentation
> AND am good at it, typically using XML (via Python).
> I love Dia.  I am developing a number of things with Dia.  Any chance
> I could host the documentation?  Is there access to the original
> software documentation? Should we start from scratch?

Perhaps Doxygen (http://www.doxygen.org/) could be used as it allow to write 
code and doc at the same time ? 

Hub




Re: Source Documentation

2001-03-20 Thread Scott Harrison

I have a stable machine on a gigabyte network.  I enjoy documentation
AND am good at it, typically using XML (via Python).
I love Dia.  I am developing a number of things with Dia.  Any chance
I could host the documentation?  Is there access to the original
software documentation? Should we start from scratch?
-Scott

"Ben A. Hetland" wrote:
> 
> Hello,
> 
> I'm looking into embedding parts of the Dia code into one of my own
> applications (mainly for drawing very simple diagrams with predefined
> symbols), and if it can contribute to the improvement of Dia itself
> that's just a bonus for everyone...
> 
> However, in this context of doing this, and extracting the components
> I need (and as little as possible in excess of this), I'm looking for
> any sources of documentation of the code structure (design), to help
> me perhaps save some time getting to know the basic design ideas and
> philosophy...
> 
> Judging from the home page and the CVS tree, such documentation (at
> the programming level -- not the end-user level) seems to be scarce
> at the moment. (Basically the README file and a fair amount of source
> code comments.) Does any such doc exist (available) that I'm not
> aware of? Some class diagrams, for instance?
> 
> I could of course "reverse-engineer" the source myself, but that seems
> a bit waste of time and pointless since somebody obviously have done
> some "engineering" to design the product in the first place...
> 
> (And the Dia Documentation Project's web page seems to have been down
> "forever" now...)
> 
> Any pointers here?
> I'm of course willing to contribute myself...
> 
> (For other reasons, not related to the Dia inclusions, I will mainly
> be working under Win32 on this project, and with MFC as well...)
> 
> Regards,
> -+-Ben-+-




Source Documentation

2001-03-20 Thread Ben A. Hetland

Hello,

I'm looking into embedding parts of the Dia code into one of my own
applications (mainly for drawing very simple diagrams with predefined
symbols), and if it can contribute to the improvement of Dia itself
that's just a bonus for everyone...

However, in this context of doing this, and extracting the components
I need (and as little as possible in excess of this), I'm looking for
any sources of documentation of the code structure (design), to help
me perhaps save some time getting to know the basic design ideas and
philosophy...

Judging from the home page and the CVS tree, such documentation (at
the programming level -- not the end-user level) seems to be scarce
at the moment. (Basically the README file and a fair amount of source
code comments.) Does any such doc exist (available) that I'm not
aware of? Some class diagrams, for instance?

I could of course "reverse-engineer" the source myself, but that seems
a bit waste of time and pointless since somebody obviously have done
some "engineering" to design the product in the first place...

(And the Dia Documentation Project's web page seems to have been down
"forever" now...)


Any pointers here?
I'm of course willing to contribute myself...


(For other reasons, not related to the Dia inclusions, I will mainly
be working under Win32 on this project, and with MFC as well...)


Regards,
-+-Ben-+-




Re: documentation

2000-09-12 Thread Lars Clausen


On Tue, 12 Sep 2000, Harry George wrote:

> 
> Try the (unofficial) Dia tutorial at:
> 
>  http://www.seanet.com/~hgg9140/comp/index.html

Since it's actually a quite decent tutorial, I'll include it in the dia-web
as a piece of documentation.

-Lars

-- 
Lars Clausen (http://shasta.cs.uiuc.edu/~lrclause) | Hårdgrim of Numenor
"I do not agree with a word that you say, but I| Retainer of Sir Kegg
will defend to the death your right to say it."|   of Westfield
--Evelyn Beatrice Hall paraphrasing Voltaire   | Chaos Berserker of Khorne




Re: Re: documentation

2000-09-12 Thread Harry George


Try the (unofficial) Dia tutorial at:

  http://www.seanet.com/~hgg9140/comp/index.html

On 11 Sep 2000, Lars Clausen wrote:
> Date: 11 Sep 2000 22:13:49 -0500
> To: [EMAIL PROTECTED]
> From: Lars Clausen <[EMAIL PROTECTED]>
> Reply-To: [EMAIL PROTECTED]
> Subject: Re: documentation
> 
> On Mon, 11 Sep 2000, Dalbir Singh wrote:
> 
> > hai,
> > I am a college student and interested with DIa which run on LInux.
> > i would to learn more about DIa biut there is no documentation .
> > how can i get the dicumentation
> > pls mail me the link or the documenation to me.
> > i really nedd it and i am seroius.
> > pls help me men.
> > bye
> 
> The documentation is terribly scarce.  We had some a long time ago, but
> it
> disappeared, and somehow nobody has made a new set.  Partly because most
> of
> it can be figured out once you know to use the right and middle mouse
> button menus and double-clicking for changing properties.
> 
> -Lars
> 
> -- 
> Lars Clausen (http://shasta.cs.uiuc.edu/~lrclause) | Hårdgrim of Numenor
> "I do not agree with a word that you say, but I| Retainer of Sir Kegg
> will defend to the death your right to say it."|   of Westfield
> --Evelyn Beatrice Hall paraphrasing Voltaire   | Chaos Berserker of
> Khorne
> 
> 
> 
-- 
Harry George
[EMAIL PROTECTED]





Re: documentation

2000-09-12 Thread Mark Besner

Hi,
Just so you all know:
The tutorial was created by Harry George ( [EMAIL PROTECTED] ).  I just
posted the link...

cya
mark

Lars Clausen wrote:
> 
> On Tue, 12 Sep 2000, Mark Besner wrote:
> 
> > Hi,
> > You may want to look at :
> > http://www.seanet.com/~hgg9140/comp/index.html
> >
> > hope it helps :)
> 
> Nice tutorial, we needed that.  Thanks!
> 
> A couple notes:
> 
> When making the lines initially, they snap to connection points (and in the
> newest CVS, they snap at both ends).  You don't have to make the line, then
> correct with the pointer.
> 
> You can change the attributes (like font, line width) for a group of
> objects at the same time (have to group them first).
> 
> Aligning is not as confusing if you think of it as aligning their
> horizontal positions.  It's also very useful for centering text in boxes
> (except that they somehow don't quite work right now... *growl*).
> 
> The check boxes in the Select menu controls how the set of selected objects
> is determined.  Normal select is replace.  The rest are most interesting when
> you drag-select.  Think of the original selection as one set of objects and
> the dragged-select as another set.  The check boxes then determines the
> set operation used to combine the two:
> 
> Previously selected:  A, B, C
> Drag-selected: B, C, D
> 
> The selection becomes:
> Select/Replace:  B, C, D
> Select/Union: A, B, C, D
> Select/Intersect: B, C
> Select/Remove: A
> Select/Invert: A, D (seems broken, though).
> 
> -Lars
> 
> --
> Lars Clausen (http://shasta.cs.uiuc.edu/~lrclause) | Hårdgrim of Numenor
> "I do not agree with a word that you say, but I| Retainer of Sir Kegg
> will defend to the death your right to say it."|   of Westfield
> --Evelyn Beatrice Hall paraphrasing Voltaire   | Chaos Berserker of Khorne




Re: documentation

2000-09-12 Thread Lars Clausen

On Tue, 12 Sep 2000, Mark Besner wrote:

> Hi,
> You may want to look at :
> http://www.seanet.com/~hgg9140/comp/index.html
> 
> hope it helps :)

Nice tutorial, we needed that.  Thanks!

A couple notes:

When making the lines initially, they snap to connection points (and in the
newest CVS, they snap at both ends).  You don't have to make the line, then
correct with the pointer.

You can change the attributes (like font, line width) for a group of
objects at the same time (have to group them first).

Aligning is not as confusing if you think of it as aligning their
horizontal positions.  It's also very useful for centering text in boxes
(except that they somehow don't quite work right now... *growl*).

The check boxes in the Select menu controls how the set of selected objects
is determined.  Normal select is replace.  The rest are most interesting when
you drag-select.  Think of the original selection as one set of objects and
the dragged-select as another set.  The check boxes then determines the
set operation used to combine the two:

Previously selected:  A, B, C
Drag-selected: B, C, D

The selection becomes:
Select/Replace:  B, C, D
Select/Union: A, B, C, D
Select/Intersect: B, C
Select/Remove: A
Select/Invert: A, D (seems broken, though).

-Lars

-- 
Lars Clausen (http://shasta.cs.uiuc.edu/~lrclause) | Hårdgrim of Numenor
"I do not agree with a word that you say, but I| Retainer of Sir Kegg
will defend to the death your right to say it."|   of Westfield
--Evelyn Beatrice Hall paraphrasing Voltaire   | Chaos Berserker of Khorne




Re: documentation

2000-09-12 Thread Mark Besner

Hi,
You may want to look at :
http://www.seanet.com/~hgg9140/comp/index.html

hope it helps :)

Mark

> Dalbir Singh wrote:
> 
> hai,
> I am a college student and interested with DIa which run on LInux.
> i would to learn more about DIa biut there is no documentation .
> how can i get the dicumentation
> pls mail me the link or the documenation to me.
> i really nedd it and i am seroius.
> pls help me men.
> bye




Re: documentation

2000-09-11 Thread Lars Clausen

On Mon, 11 Sep 2000, Dalbir Singh wrote:

> hai,
> I am a college student and interested with DIa which run on LInux.
> i would to learn more about DIa biut there is no documentation .
> how can i get the dicumentation
> pls mail me the link or the documenation to me.
> i really nedd it and i am seroius.
> pls help me men.
> bye

The documentation is terribly scarce.  We had some a long time ago, but it
disappeared, and somehow nobody has made a new set.  Partly because most of
it can be figured out once you know to use the right and middle mouse
button menus and double-clicking for changing properties.

-Lars

-- 
Lars Clausen (http://shasta.cs.uiuc.edu/~lrclause) | Hårdgrim of Numenor
"I do not agree with a word that you say, but I| Retainer of Sir Kegg
will defend to the death your right to say it."|   of Westfield
--Evelyn Beatrice Hall paraphrasing Voltaire   | Chaos Berserker of Khorne




documentation

2000-09-11 Thread Dalbir Singh



hai,
I am a college student and interested with DIa 
which run on LInux.
i would to learn more about DIa biut there is no 
documentation .
how can i get the dicumentation
pls mail me the link or the documenation to 
me.
i really nedd it and i am seroius.
pls help me men.
bye


Documentation and objects

2000-07-25 Thread Magnus Sandberg

Hi,

I'm new subscriber of this list and would like to say hi to you all.

I have the feeling the Dia is much more useful than Xfig, when I'm doing 
some network documentation. Especially when I prefer to work on my Linux 
box instead of be forced to use a Windows tool like Visio...

First of all I wonder where I can find any documentation for Dia.

I also have a question of how I can modify and create own objects to the 
object library?

Thanks!


  _\\|//_
  (-0-0-)
/---ooO-(_)-Ooo--\
| Magnus SandbergEmail: [EMAIL PROTECTED]  |
| Network Engineer, BlueLabs AB  http://www.bluelabs.se/ |
| Phone: +46-8-470 2155(FAX: +46-8-470 2199)GSM: +46-708-225 805 |
\/
  ||   ||
 ooO   Ooo






Documentation?

2000-05-26 Thread Mark Purtill


Can anyone point me to any documentation for Dia?  I'm
thinking stuff like "double click on a class icon to change the name
of the class", which I only discovered by accident.

--
^.-.^ Mark Purtill <[EMAIL PROTECTED]> or (425)893-8507
((")) The Software Revolution Inc. 2800 Northup Way Bellevue WA 98004




Re: Dia Documentation Project?

2000-04-13 Thread Alexander Larsson

On Thu, 13 Apr 2000, James Henstridge wrote:
> I just need Alex to update the copy on the web server for this.

 Done.

/ Alex





Re: Dia Documentation Project?

2000-04-13 Thread Felix Natter

James Henstridge <[EMAIL PROTECTED]> writes:

> If we are going to do new documentation for dia, it is probably best to do
> it in XML compatible docbook format, as it can be converted easily to html
> or postscript, and the gnome 2.0 help browser will probably support it
> natively.
> 
> There are some RPMS for tools to work with docbook available at:
>   http://sourceware.cygnus.com/docbook-tools/

O'Reilly publishes docbook - the definitive guide under an open publication
license online: you can find it from
http://www.ora.com

-- 
Felix Natter




Re: Dia Documentation Project?

2000-04-13 Thread Ronald L. Chichester

Lars Clausen wrote:
> I say we put it up as soon as at all possible, ready or not.  A slightly
> buggy FAQ is better than no FAQ, esp. as it will answer all the trivial
> 'use right mouse button' questions.  All in the spirit of 'release early,
> release often'.  Can it go into CVS under dia-web, maybe?

I'll second that suggestion.  Code is information.  Documentation is
information.  Early and often applies equally well to both.  The CVS
tree is the proper place for it.

Thats my $0.02

Ron
 ./.




Re: Dia Documentation Project?

2000-04-13 Thread Lars Clausen

On Thu, 13 Apr 2000, [EMAIL PROTECTED] wrote:

> On Thu, 13 Apr 2000, Fabrice Lorrain wrote:
> 
>> Justin Couch wrote:
>> > Has someone put together a FAQ for the project? (I reckon I could
>> > contribute at least 5 questions just from 2 days of fulltime usage!)
>> 
>> I've started some work on it. I will try to sent a first draft for this
>> we.
> 
> When it is ready we can put it up on the web site.

I say we put it up as soon as at all possible, ready or not.  A slightly
buggy FAQ is better than no FAQ, esp. as it will answer all the trivial
'use right mouse button' questions.  All in the spirit of 'release early,
release often'.  Can it go into CVS under dia-web, maybe?

-Lars

-- 
Lars Clausen (http://shasta.cs.uiuc.edu/~lrclause) | Hårdgrim of Numenor
"I do not agree with a word that you say, but I| Retainer of Sir Kegg
will defend to the death your right to say it."|   of Westfield
--Evelyn Beatrice Hall paraphrasing Voltaire   | Chaos Berserker of Khorne




Re: Dia Documentation Project?

2000-04-13 Thread Paul Fuller

G'day

I haven't got allot of time until atleast next week, preferably easter
break. 
I'm running 95 with the GTK+ libs to run Dia. I'm downloading Xeena from
IBM alphaworks web site. 

Paul


James Henstridge wrote:
> 
> If we are going to do new documentation for dia, it is probably best to do
> it in XML compatible docbook format, as it can be converted easily to html
> or postscript, and the gnome 2.0 help browser will probably support it
> natively.
> 
> There are some RPMS for tools to work with docbook available at:
>   http://sourceware.cygnus.com/docbook-tools/
> 
> James.
> 
> --
> Email: [EMAIL PROTECTED]
> WWW:   http://www.daa.com.au/~james/
> 
> On Thu, 13 Apr 2000, Paul Fuller wrote:
> 
> > I'm up for some basic documentation. Do a few pages here and there as
> > practice for my uni subjects [technical documentation, etc. :)]
> >
> > Purpose
> >  few sentences
> > Contents
> >  1..n sections
> > Introduction
> >  few paragraphs
> > Actions(how to)
> >  As much as possible.
> > Index
> >  Links to words throughout the document
> >
> > Can you do this in an editor then port/save it as a link html document?
> >
> > Anyone else? easter break is coming up?..
> >
> > I speak english only!
> >
> > Paul
> >
> >
> > Lars Clausen wrote:
> > >
> > > On Thu, 13 Apr 2000, [EMAIL PROTECTED] wrote:
> > >
> > > > Justin Couch wrote:
> > > >>
> > > >> Just went looking for more documentation about how to use Dia (even
> > > >> Dia-Hacking-Howto:) and got 404'd on the link. What is the state of
> > > >> this area?
> > > > Down for quite sometime now, might be nice to remove it definitely from
> > > > the web pages ??
> > >
> > > Yeah, it's not going to come back, it seems, so I'd rather see some new
> > > stuff come in ASAP.
> > >
> > > >> Has someone put together a FAQ for the project? (I reckon I could
> > > >> contribute at least 5 questions just from 2 days of fulltime usage!)
> > > >
> > > > I've started some work on it. I will try to sent a first draft for this
> > > > we.
> > >
> > > Good!  Anything is better than a 404.
> > >
> > > -Lars
> > >
> > > --
> > > Lars Clausen (http://shasta.cs.uiuc.edu/~lrclause) | Hårdgrim of Numenor
> > > "I do not agree with a word that you say, but I| Retainer of Sir Kegg
> > > will defend to the death your right to say it."|   of Westfield
> > > --Evelyn Beatrice Hall paraphrasing Voltaire   | Chaos Berserker of Khorne
> >
> > --
> > Paul Fuller + [EMAIL PROTECTED] + Undergraduate
> > B.Sc(CompSci)
> > --
> >

--
Paul Fuller + [EMAIL PROTECTED] + Undergraduate
B.Sc(CompSci)
--




Re: Dia Documentation Project?

2000-04-13 Thread James Henstridge

If we are going to do new documentation for dia, it is probably best to do
it in XML compatible docbook format, as it can be converted easily to html
or postscript, and the gnome 2.0 help browser will probably support it
natively.

There are some RPMS for tools to work with docbook available at:
  http://sourceware.cygnus.com/docbook-tools/

James.

--
Email: [EMAIL PROTECTED]
WWW:   http://www.daa.com.au/~james/


On Thu, 13 Apr 2000, Paul Fuller wrote:

> I'm up for some basic documentation. Do a few pages here and there as
> practice for my uni subjects [technical documentation, etc. :)]
> 
> Purpose
>  few sentences
> Contents
>  1..n sections
> Introduction
>  few paragraphs
> Actions(how to)
>  As much as possible.
> Index
>  Links to words throughout the document
> 
> Can you do this in an editor then port/save it as a link html document? 
> 
> Anyone else? easter break is coming up?.. 
> 
> I speak english only!
> 
> Paul
> 
> 
> Lars Clausen wrote:
> > 
> > On Thu, 13 Apr 2000, [EMAIL PROTECTED] wrote:
> > 
> > > Justin Couch wrote:
> > >>
> > >> Just went looking for more documentation about how to use Dia (even
> > >> Dia-Hacking-Howto:) and got 404'd on the link. What is the state of
> > >> this area?
> > > Down for quite sometime now, might be nice to remove it definitely from
> > > the web pages ??
> > 
> > Yeah, it's not going to come back, it seems, so I'd rather see some new
> > stuff come in ASAP.
> > 
> > >> Has someone put together a FAQ for the project? (I reckon I could
> > >> contribute at least 5 questions just from 2 days of fulltime usage!)
> > >
> > > I've started some work on it. I will try to sent a first draft for this
> > > we.
> > 
> > Good!  Anything is better than a 404.
> > 
> > -Lars
> > 
> > --
> > Lars Clausen (http://shasta.cs.uiuc.edu/~lrclause) | Hårdgrim of Numenor
> > "I do not agree with a word that you say, but I| Retainer of Sir Kegg
> > will defend to the death your right to say it."|   of Westfield
> > --Evelyn Beatrice Hall paraphrasing Voltaire   | Chaos Berserker of Khorne
> 
> --
> Paul Fuller + [EMAIL PROTECTED] + Undergraduate
> B.Sc(CompSci)
> --
> 




Re: Dia Documentation Project?

2000-04-13 Thread James Henstridge

On Thu, 13 Apr 2000, Fabrice Lorrain wrote:

> Justin Couch wrote:
> > 
> > Just went looking for more documentation about how to use Dia (even
> > Dia-Hacking-Howto:) and got 404'd on the link. What is the state of
> > this area?
> Down for quite sometime now, might be nice to remove it definitely from
> the web pages ??

I have added a comment to the link noting that it is down.  I doubt that
it is comming back though.

I also updated the link to the gyve and diacanvas sites, and changed the
contact link in the menu to point to a page explaining about that you
won't get any responses from the mailing list if you aren't subscribed.

I just need Alex to update the copy on the web server for this.

> 
> > 
> > Has someone put together a FAQ for the project? (I reckon I could
> > contribute at least 5 questions just from 2 days of fulltime usage!)
> 
> I've started some work on it. I will try to sent a first draft for this
> we.

When it is ready we can put it up on the web site.

> 
> Fab
> 

James.




Re: Dia Documentation Project?

2000-04-13 Thread Paul Fuller

I'm up for some basic documentation. Do a few pages here and there as
practice for my uni subjects [technical documentation, etc. :)]

Purpose
 few sentences
Contents
 1..n sections
Introduction
 few paragraphs
Actions(how to)
 As much as possible.
Index
 Links to words throughout the document

Can you do this in an editor then port/save it as a link html document? 

Anyone else? easter break is coming up?.. 

I speak english only!

Paul


Lars Clausen wrote:
> 
> On Thu, 13 Apr 2000, [EMAIL PROTECTED] wrote:
> 
> > Justin Couch wrote:
> >>
> >> Just went looking for more documentation about how to use Dia (even
> >> Dia-Hacking-Howto:) and got 404'd on the link. What is the state of
> >> this area?
> > Down for quite sometime now, might be nice to remove it definitely from
> > the web pages ??
> 
> Yeah, it's not going to come back, it seems, so I'd rather see some new
> stuff come in ASAP.
> 
> >> Has someone put together a FAQ for the project? (I reckon I could
> >> contribute at least 5 questions just from 2 days of fulltime usage!)
> >
> > I've started some work on it. I will try to sent a first draft for this
> > we.
> 
> Good!  Anything is better than a 404.
> 
> -Lars
> 
> --
> Lars Clausen (http://shasta.cs.uiuc.edu/~lrclause) | Hårdgrim of Numenor
> "I do not agree with a word that you say, but I| Retainer of Sir Kegg
> will defend to the death your right to say it."|   of Westfield
> --Evelyn Beatrice Hall paraphrasing Voltaire   | Chaos Berserker of Khorne

--
Paul Fuller + [EMAIL PROTECTED] + Undergraduate
B.Sc(CompSci)
--




Re: Dia Documentation Project?

2000-04-13 Thread Lars Clausen

On Thu, 13 Apr 2000, [EMAIL PROTECTED] wrote:

> Justin Couch wrote:
>> 
>> Just went looking for more documentation about how to use Dia (even
>> Dia-Hacking-Howto:) and got 404'd on the link. What is the state of
>> this area?
> Down for quite sometime now, might be nice to remove it definitely from
> the web pages ??

Yeah, it's not going to come back, it seems, so I'd rather see some new
stuff come in ASAP.

>> Has someone put together a FAQ for the project? (I reckon I could
>> contribute at least 5 questions just from 2 days of fulltime usage!)
> 
> I've started some work on it. I will try to sent a first draft for this
> we.

Good!  Anything is better than a 404.

-Lars

-- 
Lars Clausen (http://shasta.cs.uiuc.edu/~lrclause) | Hårdgrim of Numenor
"I do not agree with a word that you say, but I| Retainer of Sir Kegg
will defend to the death your right to say it."|   of Westfield
--Evelyn Beatrice Hall paraphrasing Voltaire   | Chaos Berserker of Khorne




Re: Dia Documentation Project?

2000-04-13 Thread Fabrice Lorrain

Justin Couch wrote:
> 
> Just went looking for more documentation about how to use Dia (even
> Dia-Hacking-Howto:) and got 404'd on the link. What is the state of
> this area?
Down for quite sometime now, might be nice to remove it definitely from
the web pages ??

> 
> Has someone put together a FAQ for the project? (I reckon I could
> contribute at least 5 questions just from 2 days of fulltime usage!)

I've started some work on it. I will try to sent a first draft for this
we.

Fab




Dia Documentation Project?

2000-04-12 Thread Justin Couch

Just went looking for more documentation about how to use Dia (even
Dia-Hacking-Howto:) and got 404'd on the link. What is the state of
this area?

Has someone put together a FAQ for the project? (I reckon I could
contribute at least 5 questions just from 2 days of fulltime usage!)

-- 
Justin Couch   Author, Java Hacker
Snr Software Engineer [EMAIL PROTECTED]
rbuzz.net   http://www.vlc.com.au/~justin/
Java3D FAQ http://www.j3d.org/faq/
---
"Look through the lens, and the light breaks down into many lights.
 Turn it or move it, and a new set of arrangements appears... is it
 a single light or many lights, lights that one must know how to
 distinguish, recognise and appreciate? Is it one light with many
 frames or one frame for many lights?"  -Subcomandante Marcos
---




Re: critical bug / documentation

2000-03-22 Thread Fabrice Lorrain (home)

Volker Schoech wrote:
> 
> Hi folks,
> I have no idea if this email reaches anybody -- last time I sent a
> message to this address, I got no response. :-(
> 
> Anyway, here's my problem: I'm using dia 0.80 (because I like
> rpm-format). I created a small diagram (less than 50 Elements
> alltogether) and saved it to a file. But when I want to open that
> particular file in dia again, dia consumes all the available
> memory and swap space until my entire X-Windows system crashes.
> Boff! I attached the file in question.

No pb with dia 0.84 (debian package). I guess that it would be better to
upgrade
to that version (lot's of bugs smashed ;-).
You can grabe a rpm version at :
  ftp://ftp.fl.priv.at/pub/dia/current/dia-0.84-1.i386.rpm
Rem : it's a rpm for Suse 6.3.

Otherwise you can install alien and convert the debian package :
 
ftp.de.debian.org/pub/debian/dists/woody/main/binary-i386/graphics/dia_0.84-1.deb

Have a look at the archives for dependencies problems (libxml and
other)  :
  http://www.mail-archive.com/dia-list@lysator.liu.se/

A+,

Fab




Re: critical bug / documentation

2000-03-22 Thread Jeroen Ruigrok van der Werven

-On [2322 17:50], Volker Schoech ([EMAIL PROTECTED]) wrote:
>
>Anyway, here's my problem: I'm using dia 0.80 (because I like
>rpm-format). I created a small diagram (less than 50 Elements
>alltogether) and saved it to a file. But when I want to open that
>particular file in dia again, dia consumes all the available
>memory and swap space until my entire X-Windows system crashes.
>Boff! I attached the file in question.

Get 0.84 and see if that solves your problem.

>Another thing worth mentioning is the fact that the dia
>documentation project either moved or collapsed. All I can say is
>that the link in the dia site leads to a 404.

We know, working on it.

-- 
Jeroen Ruigrok van der Werven  Network- and systemadministrator
<[EMAIL PROTECTED]>  VIA NET.WORKS The Netherlands
BSD: Technical excellence at its best  http://www.bart.nl
Yet each man kills the thing he loves...




critical bug / documentation

2000-03-22 Thread Volker Schoech

Hi folks,
I have no idea if this email reaches anybody -- last time I sent a
message to this address, I got no response. :-(

Anyway, here's my problem: I'm using dia 0.80 (because I like
rpm-format). I created a small diagram (less than 50 Elements
alltogether) and saved it to a file. But when I want to open that
particular file in dia again, dia consumes all the available
memory and swap space until my entire X-Windows system crashes.
Boff! I attached the file in question.

Another thing worth mentioning is the fact that the dia
documentation project either moved or collapsed. All I can say is
that the link in the dia site leads to a 404.

Greetings,
   V.

--
 Volker Schoech  //  http://www.Tau-web.de 
 Windows? Gesehen... gelacht... geloescht!
 HTML-components.dia


Re: broken links on the web and documentation

2000-03-09 Thread James Henstridge

Cool.  Do it in whatever format is easiest for you.  If we decide to
change the format later, it is not much work to add markup.  Feel free to
ask for answers on the list :)

James.

--
Email: [EMAIL PROTECTED]
WWW:   http://www.daa.com.au/~james/


On Thu, 9 Mar 2000, Fabrice Lorrain (home) wrote:

> Ok, I will start the FAQ this weekend unless someone else wants to do
> it.
> 
> I grabed the pages of the Dia Documentation Project from google, there
> is not much there. But if anyone wants them ...
> 
> To me the documentation should be on the DIA web site.
> 
> As of the format, I was thinking to start with a plain text FAQ but if
> you want sth more elaborate, I can give a try to sgmltools/docbook or
> use the gdp.
> My first idea was to have the FAQ done more than the "howto do it"
> stuff.
> 
> CVS access is a bit early for now unless there is more than the FAQ to
> do.
> 
> Fab
> 



Re: broken links on the web and documentation

2000-03-09 Thread Fabrice Lorrain (home)

Ok, I will start the FAQ this weekend unless someone else wants to do
it.

I grabed the pages of the Dia Documentation Project from google, there
is not much there. But if anyone wants them ...

To me the documentation should be on the DIA web site.

As of the format, I was thinking to start with a plain text FAQ but if
you want sth more elaborate, I can give a try to sgmltools/docbook or
use the gdp.
My first idea was to have the FAQ done more than the "howto do it"
stuff.

CVS access is a bit early for now unless there is more than the FAQ to
do.

Fab



RE: broken links on the web and documentation

2000-03-09 Thread bill . helke

My first thought on reading all the posts about docs was:

"Well, duh, why not get 'em into GDP?"  Dia is, after all, supposed to be a
component of GNOME Office, no?

My vote is to move what little you've got into GDP and point all the users
who want to work on docs to the GNOME site to sign up and work on them.

William F. Helke

-Original Message-
From: James Henstridge [mailto:[EMAIL PROTECTED]]
Sent: Thursday, March 09, 2000 3:50 AM
To: [EMAIL PROTECTED]
Subject: Re: broken links on the web and documentation


I don't think we have heard from the original dia documentation
maintainers for a while and the old web site seems out of commission.

I think it would be fairly safe to start it up again with new maintainers.

A few questions that we should think about:
  - should the documentation be on a web site or included with dia or
both?
  - what format should it be in?  The old stuff looks like hand coded
HTML.  Another option is docbook format.  It can be translated into a
number of useful formats, and if you make it XML compliant mozilla
(and probably internet explorer) can render it directly with the
appropriate stylesheets.
  - Do we want to develop the documentation under the GNOME documentation
project.  They already have a bit of infrastructure set up to help
write docs.  More info is available from http://www.gnome.org/gdp/
  - Where should the master copy be stored?  The old docs were on a web
site, and when the web site went down we lost the documentation.  I
think using CVS for this would probably be a good idea, and it gives
us revision control for free.

It is probably a good idea to have non dia hackers working on the
documentation, as they will have a better idea of what needs to be
included (I know where most buttons are in the software, as I wrote it :)

If you want to keep the docs on CVS, I can organise CVS access for one or
two people who want to do this.

And a note for Lars -- if you want CVS access, just ask.

James.

--
Email: [EMAIL PROTECTED]
WWW:   http://www.daa.com.au/~james/


On Thu, 9 Mar 2000 [EMAIL PROTECTED] wrote:

> 
> Firstly, for all the idiots out there (like me), why is the documentation
> not on the same server as the DIA web site?  Does anyone know who the
> current maintainers of the documentation project are?  Lets say we can't
> find them, do we need a server to host the documentation on?  If so, I can
> provide one.  Does anyone want to be the new maintainer?  If not, I will
> volunteer, as user requests for documentation seem to be appearing on the
> list quite often these days, and lets face it - not everyone who uses DIA
> is bright enough to figure out how it works on their own.
> 
> I think we just need a little clarity here so a decision can be made, and
> we can move forward on this.
> 
> Dennis



Re: broken links on the web and documentation

2000-03-09 Thread Greg Ward

On 09 March 2000, James Henstridge said:
>   - should the documentation be on a web site or included with dia or
> both?

Both, unless it gets *really* big (say, more than 1.5 times the size of
the code).  At the absolute, very, minimum, the README should say,
"Documentation for Dia is available at http://".  If that's a URL
under the Dia home page, good -- less worry about it going away.

BTW, I've only been using Dia for a couple of days, and I would have got
absolutely *nowhere* with it without the old docs in the Google cache.
Obviously, this is *not* a good place to send new users for
documentation.

>   - what format should it be in?  The old stuff looks like hand coded
> HTML.  Another option is docbook format.  It can be translated into a
> number of useful formats, and if you make it XML compliant mozilla
> (and probably internet explorer) can render it directly with the
> appropriate stylesheets.

Someone should resurrect the old stuff *immediately* -- who knows how
long before it expires from the Google cache?  Also, images in it need
to be recreated -- from the text, it sounds like they're all Dia
screenshots, so shouldn't be too hard.  If anyone has resurrected the
HTML docs from the Google cache and wants help recreating screenshots,
let me know -- I'd be happy to lend a hand.

It couldn't hurt to drop a line to [EMAIL PROTECTED] to ask them
what the heck happened to /diadocs on their server.  Or, for that
matter, what happened to their server?  http://www.bionode.com/ returns
"403 Forbidden".  OK, there, that's done.  Quick, lay your wagers down
now: how much you wanna bet the mail bounces sky-high?

Anyways, the old docs should be made available ASAP via a
"Documentation" link from the Dia home page.  I know nothing about the
GNOME doc infrastructure, but since Dia *is* part of the GNOME project
in some sense, it makes sense to use those tools.  Unless they suck, of
course.  ;-)

Absolutely positively the docs should be in CVS.  And I'm in favour
of apple pie and motherhood, too.

Greg
-- 
Greg Ward - software developer[EMAIL PROTECTED]
Corporation for National Research Initiatives
1895 Preston White Drive   voice: +1-703-620-8990
Reston, Virginia, USA  20191-5434fax: +1-703-620-0913



Re: broken links on the web and documentation

2000-03-09 Thread James Henstridge

I don't think we have heard from the original dia documentation
maintainers for a while and the old web site seems out of commission.

I think it would be fairly safe to start it up again with new maintainers.

A few questions that we should think about:
  - should the documentation be on a web site or included with dia or
both?
  - what format should it be in?  The old stuff looks like hand coded
HTML.  Another option is docbook format.  It can be translated into a
number of useful formats, and if you make it XML compliant mozilla
(and probably internet explorer) can render it directly with the
appropriate stylesheets.
  - Do we want to develop the documentation under the GNOME documentation
project.  They already have a bit of infrastructure set up to help
write docs.  More info is available from http://www.gnome.org/gdp/
  - Where should the master copy be stored?  The old docs were on a web
site, and when the web site went down we lost the documentation.  I
think using CVS for this would probably be a good idea, and it gives
us revision control for free.

It is probably a good idea to have non dia hackers working on the
documentation, as they will have a better idea of what needs to be
included (I know where most buttons are in the software, as I wrote it :)

If you want to keep the docs on CVS, I can organise CVS access for one or
two people who want to do this.

And a note for Lars -- if you want CVS access, just ask.

James.

--
Email: [EMAIL PROTECTED]
WWW:   http://www.daa.com.au/~james/


On Thu, 9 Mar 2000 [EMAIL PROTECTED] wrote:

> 
> Firstly, for all the idiots out there (like me), why is the documentation
> not on the same server as the DIA web site?  Does anyone know who the
> current maintainers of the documentation project are?  Lets say we can't
> find them, do we need a server to host the documentation on?  If so, I can
> provide one.  Does anyone want to be the new maintainer?  If not, I will
> volunteer, as user requests for documentation seem to be appearing on the
> list quite often these days, and lets face it - not everyone who uses DIA
> is bright enough to figure out how it works on their own.
> 
> I think we just need a little clarity here so a decision can be made, and
> we can move forward on this.
> 
> Dennis



Re: broken links on the web and documentation

2000-03-09 Thread Florian-Daniel Otel




> Firstly, for all the idiots out there (like me), why is the documentation
> not on the same server as the DIA web site?  Does anyone know who the
> current maintainers of the documentation project are?  Lets say we can't
> find them, do we need a server to host the documentation on?  If so, I can
> provide one.  Does anyone want to be the new maintainer?  If not, I will
> volunteer, as user requests for documentation seem to be appearing on the
> list quite often these days, and lets face it - not everyone who uses DIA
> is bright enough to figure out how it works on their own.

> I think we just need a little clarity here so a decision can be made, and
> we can move forward on this.

My $0.02 worth:

A documentation project would be more than welcome. Especially a
FAQ. For example i keep postponing reading _carefully_ my own spooled
mails from the dia list that (AFAIR) contain quite a number of useful
hints like:  how to apply the properties from one object to another,
ruler units/scaling problems, how to create new objects and put them
into sheets,etc. 

And, as i am not using dia on a daily basis after i "discover" how to
do something i forget 'till next time i have use it, curse why the hell
didn't I wrote down how i did that "something" and I end up
"rediscovering" it after greping the mail archives.

In these case severe case of laziness (and i am sure there are a lot
of them out there) having a FAQ/documentation project would be a
bliss. Also IMHO it will help the developers from not having to ask the
same questions over and over again when "Jhonny come lately" joins the 
party.

I am sure that a couple of hours of browsing the mailing list archives
will provide enough material.

> Dennis


Cheers,

Florian.



Re: broken links on the web and documentation

2000-03-08 Thread djhouy


Firstly, for all the idiots out there (like me), why is the documentation
not on the same server as the DIA web site?  Does anyone know who the
current maintainers of the documentation project are?  Lets say we can't
find them, do we need a server to host the documentation on?  If so, I can
provide one.  Does anyone want to be the new maintainer?  If not, I will
volunteer, as user requests for documentation seem to be appearing on the
list quite often these days, and lets face it - not everyone who uses DIA
is bright enough to figure out how it works on their own.

I think we just need a little clarity here so a decision can be made, and
we can move forward on this.

Dennis



   
 
James  
 
Henstridge   To: [EMAIL PROTECTED]   
 
<[EMAIL PROTECTED]cc:   
 
m.au>Subject: Re: broken links on the web and 
documentation 
   
 
09-03-2000 
 
01:58 AM   
 
Please 
 
respond to 
 
dia-list   
 
   
 
   
 



I don't know what the status of the web server where the documentation
project is -- whether it is a temporary problem or a permanent one.  Some
of the old project is cached in google (not all of it), if someone wants
to take over maintainership (assuming the previous maintainers can't be
found).  Just go to www.google.com and search for dia documentation
project and click on the links.  Note that you can't get any of the images
this way.

James.

--
Email: [EMAIL PROTECTED]
WWW:   http://www.daa.com.au/~james/


On Wed, 8 Mar 2000, Fabrice Lorrain wrote:

> As stated by others, the links to the "Dia Documentation Project" and to
> the "UML Tutoriel" are broken (at least since saturday).
>
> Does someone know the state of the Documentation Project (dead,
> temporary problems, other) ?? And what they have done as of
> documentation ??
>
> Fab
>







Re: broken links on the web and documentation

2000-03-08 Thread James Henstridge

I don't know what the status of the web server where the documentation
project is -- whether it is a temporary problem or a permanent one.  Some
of the old project is cached in google (not all of it), if someone wants
to take over maintainership (assuming the previous maintainers can't be
found).  Just go to www.google.com and search for dia documentation
project and click on the links.  Note that you can't get any of the images
this way.

James.

--
Email: [EMAIL PROTECTED]
WWW:   http://www.daa.com.au/~james/


On Wed, 8 Mar 2000, Fabrice Lorrain wrote:

> As stated by others, the links to the "Dia Documentation Project" and to 
> the "UML Tutoriel" are broken (at least since saturday).
> 
> Does someone know the state of the Documentation Project (dead,
> temporary problems, other) ?? And what they have done as of
> documentation ??
> 
> Fab
> 



broken links on the web and documentation

2000-03-08 Thread Fabrice Lorrain

As stated by others, the links to the "Dia Documentation Project" and to 
the "UML Tutoriel" are broken (at least since saturday).

Does someone know the state of the Documentation Project (dead,
temporary problems, other) ?? And what they have done as of
documentation ??

Fab



Re: documentation for dia

2000-03-06 Thread Jeroen Ruigrok van der Werven

-On [2306 11:50], T. Tam ([EMAIL PROTECTED]) wrote:
>I'd like to volunteer documentation skills as well.  As well as (mediocre)
>HTML skills). (My webpage is at students.washington.edu/ttstam/ you may
>check it out as a example of what I'm limited to 8-) )

Cool.

For documentation I prefer to use DocBook and then convert it through
teTeX/jade and dsssl to HTML or other formats...

Btw, I am part of the FreeBSD documentation project committers as well
as doing the BSD Programmer's Documentation Project at my site:

http://home.wxs.nl/~asmodai

Is there anyone who is actively doing documentation for Dia at the
moment?

-- 
Jeroen Ruigrok van der Werven  Network- and systemadministrator
<[EMAIL PROTECTED]>  VIA NET.WORKS The Netherlands
BSD: Technical excellence at its best  http://www.bart.nl
Tel: +31 - (0) 10 - 240 39 70  http://www.via-net-works.com



Re: documentation for dia

2000-03-06 Thread T. Tam

I'd like to volunteer documentation skills as well.  As well as (mediocre)
HTML skills). (My webpage is at students.washington.edu/ttstam/ you may
check it out as a example of what I'm limited to 8-) )

Also:  Is there anyway to have Dia preload only a specific set of
templates, much like Visio?

-=- Terence

On Mon, 6 Mar 2000, Jeroen Ruigrok van der Werven wrote:

> -On [2305 16:10], dave frost ([EMAIL PROTECTED]) wrote:
> >Great program !
> 
> Indeed.
> 
> >Though you documentation link(in the links page) is out of date and
> >can't be accessed.
> 
> Yeah unfortunately...
> 
> >I think it would also be nice if there was an option to draw in a
> >single page at a time, not having page breaks.
> 
> A single page would definately be the default for my work, another thing
> which `bothers me' is that the default sizes for the single pages are
> way too big...
> 
> I would even volunteer my documentation skills for the cause of the
> project if people would help me with documenting bu telling what is
> possible and all that.
> 
> -- 
> Jeroen Ruigrok van der Werven  Network- and systemadministrator
> <[EMAIL PROTECTED]>  VIA NET.WORKS The Netherlands
> BSD: Technical excellence at its best  http://www.bart.nl
> Tel: +31 - (0) 10 - 240 39 70  http://www.via-net-works.com
> 
> 



Re: documentation for dia

2000-03-06 Thread Jeroen Ruigrok van der Werven

-On [2305 16:10], dave frost ([EMAIL PROTECTED]) wrote:
>Great program !

Indeed.

>Though you documentation link(in the links page) is out of date and
>can't be accessed.

Yeah unfortunately...

>I think it would also be nice if there was an option to draw in a
>single page at a time, not having page breaks.

A single page would definately be the default for my work, another thing
which `bothers me' is that the default sizes for the single pages are
way too big...

I would even volunteer my documentation skills for the cause of the
project if people would help me with documenting bu telling what is
possible and all that.

-- 
Jeroen Ruigrok van der Werven  Network- and systemadministrator
<[EMAIL PROTECTED]>  VIA NET.WORKS The Netherlands
BSD: Technical excellence at its best  http://www.bart.nl
Tel: +31 - (0) 10 - 240 39 70  http://www.via-net-works.com



documentation for dia

2000-03-05 Thread dave frost

Hi,

Great program !  Though you documentation link(in the links page) is out
of date and can't be accessed.  I think it would also be nice if there
was an option to draw in a single page at a time, not having page
breaks.  This may already be possible buut the documentation isn't
available so 

Thanks

Dave Frost



Dia documentation project URL not found

2000-03-01 Thread Berg Hawkins

There is a broken link in the links page. It is to the "Dia Documentation
Project"

Thank You for your work.



Re: Documentation

2000-02-15 Thread Florian-Daniel Otel


> Hello,
> I have just downloaded and installed DIA on redhat 6 on a intel box .
> Thank you for making DIA available. I was wondering though... where
> are the help files?  For instance, how do I change font  for the text
> on the diagrams?

Double click on the text or choose Object->Properties. There you have
the font and its size.

> many thanks,
> Ben

Cheers,

Florian.



Re: Documentation

2000-02-15 Thread James Henstridge

You can double click on the text button in the toolbox to bring up the
defaults for that tool.  This will affect any future text objects you
place.  Double clicking on a placed text object will bring up its
properties window, from which you can set the font.

As far as documentation, there was/is a dia documentation project, but
their web site seems to be down at the moment.

James.

--
Email: [EMAIL PROTECTED]
WWW:   http://www.daa.com.au/~james/


On Wed, 16 Feb 2000, Ben Lawrence wrote:

> Hello,
> I have just downloaded and installed DIA on redhat 6 on a intel box .
> Thank you for making DIA available. I was wondering though... where
> are the help files?  For instance, how do I change font  for the text
> on the diagrams?
> many thanks,
> Ben
> --
> (Dr) Ben Lawrence
> Centre for Magnetic Resonance,
> University of Queensland,
> St Lucia, 4072,
> Brisbane, Australia.
> email: [EMAIL PROTECTED]
> Tel: +61 7 3365 6176
> Fax: +61 7 3365 3833
> 
> 



Documentation

2000-02-15 Thread Ben Lawrence

Hello,
I have just downloaded and installed DIA on redhat 6 on a intel box .
Thank you for making DIA available. I was wondering though... where
are the help files?  For instance, how do I change font  for the text
on the diagrams?
many thanks,
Ben
--
(Dr) Ben Lawrence
Centre for Magnetic Resonance,
University of Queensland,
St Lucia, 4072,
Brisbane, Australia.
email: [EMAIL PROTECTED]
Tel: +61 7 3365 6176
Fax: +61 7 3365 3833




Broken Link to Dia Documentation

2000-02-15 Thread Bernhard Rietzl

Hello,

the link to the documentation in section Links is broken.
If this is only temporary, never mind.

Bernhard Rietzl


begin:vcard 
n:Rietzl;Bernhard 
x-mozilla-html:FALSE
version:2.1
email;internet:[EMAIL PROTECTED]
org;quoted-printable:Beim Herstenhof 36=3B 72076 T=FCbingen
note:Tel. 0171/6856135
x-mozilla-cpt:;0
fn:Bernhard  Rietzl
end:vcard



Re: Link to the Dia Documentation Project

2000-01-18 Thread Steven Hirsch

Hi Ronald,

I was hoping to get a look at what's been done to date.  If anything was
ever produced, where would I find it?  If not, I've got a bit to learn
before being in the position to pen anything .

Steve



Steven N. Hirsch   tie-line: 446-6557 ext: 802-769-6557

Development Engineer   Methodology Integration Team
ASIC Products GroupIBM Microelectronics


On Tue, 18 Jan 2000, Ronald L. Chichester wrote:

> Hi:
> 
> The link to the Dia Documentation Project
> (http://www.bionode.com/diadocs/index.html) is broken.  If you need some
> place to store the documents, please contact me and I may be able to
> help.
> 
> Best wishes,
> 
> Ronald Chichester
> [EMAIL PROTECTED]
> 
> 
> 



Link to the Dia Documentation Project

2000-01-18 Thread Ronald L. Chichester

Hi:

The link to the Dia Documentation Project
(http://www.bionode.com/diadocs/index.html) is broken.  If you need some
place to store the documents, please contact me and I may be able to
help.

Best wishes,

Ronald Chichester
[EMAIL PROTECTED]



Re: Dia Documentation Project

2000-01-06 Thread Lars Clausen

On 06 Jan 2000, [EMAIL PROTECTED] wrote:

> On Thu, 6 Jan 2000, [EMAIL PROTECTED] wrote:
> 
>> Hi All
>> 
>> I tried to follow the link to the Dia Documentation Project, but it
>> seems to be dead. Is the project still in existence? I've just started
>> using Dia, and I'm finding it really neat, so I was thinking of
>> contributing some documentation.
> 
> Absolutely alive.  Take down the latest CVS version and look at the
> neatness.  Some documentation would be *wonderful*, especially of the use
> of the program.  What format(s) are you planning on using?

D'oh!
I didn't notice you were talking about the Dia *Documentation* Project.
Silly me.  I have no clue what became of that, but I'm sure we'll all be
happy if you pick it up.

-Lars

-- 
Lars R. Clausen (http://shasta.cs.uiuc.edu/~lrclause)   Hårdgrim of Westfield
"I do not agree with a word that you say, but I will defend to the death your
right to say it."  --Evelyn Beatrice Hall



Re: Dia Documentation Project

2000-01-06 Thread Lars Clausen

On Thu, 6 Jan 2000, [EMAIL PROTECTED] wrote:

> Hi All
> 
> I tried to follow the link to the Dia Documentation Project, but it seems
> to be dead. Is the project still in existence? I've just started using
> Dia, and I'm finding it really neat, so I was thinking of contributing
> some documentation.

Absolutely alive.  Take down the latest CVS version and look at the
neatness.  Some documentation would be *wonderful*, especially of the use
of the program.  What format(s) are you planning on using?

Kindly,
-Lars

-- 
Lars R. Clausen (http://shasta.cs.uiuc.edu/~lrclause)   Hårdgrim of Westfield
"I do not agree with a word that you say, but I will defend to the death your
right to say it."  --Evelyn Beatrice Hall



Dia Documentation Project

2000-01-06 Thread Mr P.A. Van Heusden

Hi All

I tried to follow the link to the Dia Documentation Project, but it seems
to be dead. Is the project still in existence? I've just started using
Dia, and I'm finding it really neat, so I was thinking of contributing
some documentation.

Peter
--
Peter van Heusden : [EMAIL PROTECTED] : PGP key available
Criticism has torn up the imaginary flowers from the chain not so that man
shall wear the unadorned, bleak chain but so that he will shake off the 
chain and pluck the living flower. - Karl Marx 
   NOTE: I do not speak for the HGMP or the MRC.