[Flightgear-devel] XML schema files for FlightGear

2009-03-13 Thread Torsten Dreyer
Hi

I recently revived the xml schema files I started to create a while ago.
While working on the autopilot for the HansaJet, I (re)learned that editing 
xml files with vi is ok, but having a nice xml editor is much more fun. Once 
you got used to the automatic popup menus offering the valid tags at your 
current editing position, you *really* miss them once they are gone...
They may also serve as a good reference and documentation.
Autogenerated documentation looks like this:
http://www.t3r.de/fg/xml/Docs/autopilot.xsd.html
(Ignore the AusAddress - this is a bug somewhere)

I have quite a few schema files with annotation ready and I think it might be 
a good idea to share them. 

What do you think? Does FlightGear need xml schema files? Would anybody 
besides me use them? What would be the appropriate place to store them?
My suggestion: data/Docs/XMLSchema

Comments welcome

Torsten

--
Apps built with the Adobe(R) Flex(R) framework and Flex Builder(TM) are
powering Web 2.0 with engaging, cross-platform capabilities. Quickly and
easily build your RIAs with Flex Builder, the Eclipse(TM)based development
software that enables intelligent coding and step-through debugging.
Download the free 60 day trial. http://p.sf.net/sfu/www-adobe-com
___
Flightgear-devel mailing list
Flightgear-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/flightgear-devel


Re: [Flightgear-devel] XML schema files for FlightGear

2009-03-13 Thread Melchior FRANZ
* Torsten Dreyer -- Friday 13 March 2009:
 http://www.t3r.de/fg/xml/Docs/autopilot.xsd.html

Looks nice.



 I have quite a few schema files with annotation ready [...]
 Does FlightGear need xml schema files? Would anybody besides me use
 them? What would be the appropriate place to store them? 

While I would probably not use that myself, I'm all for it. The
question, however, is, if someone maintains that. XML file
structure changes all the time, but if those who make the changes
don't use the schemata, then they might also not update them.
They might not even have the tools installed or know/care about
how to use them. Outdated and wrong documentation can be worse
than no documentation at all. At the moment not even our actual
documentation is really fully up-to-date, and the files in
$FG_ROOT/Docs/ and ./docs-mini/ aren't synchronized.  :-/



 My suggestion: data/Docs/XMLSchema

Makes sense.

m.


--
Apps built with the Adobe(R) Flex(R) framework and Flex Builder(TM) are
powering Web 2.0 with engaging, cross-platform capabilities. Quickly and
easily build your RIAs with Flex Builder, the Eclipse(TM)based development
software that enables intelligent coding and step-through debugging.
Download the free 60 day trial. http://p.sf.net/sfu/www-adobe-com
___
Flightgear-devel mailing list
Flightgear-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/flightgear-devel


Re: [Flightgear-devel] XML schema files for FlightGear

2009-03-13 Thread Jon S. Berndt
 Hi
 
 I recently revived the xml schema files I started to create a while
 ago.
 While working on the autopilot for the HansaJet, I (re)learned that
 editing
 xml files with vi is ok, but having a nice xml editor is much more fun.
 Once
 you got used to the automatic popup menus offering the valid tags at
 your
 current editing position, you *really* miss them once they are gone...
 They may also serve as a good reference and documentation.
 Autogenerated documentation looks like this:
 http://www.t3r.de/fg/xml/Docs/autopilot.xsd.html
 (Ignore the AusAddress - this is a bug somewhere)


This is a good thing to do. I've been trying to keep current JSBSim schema
and XSL transformation documents up to date. I use OxygenXML as an editor.
Which one do you use?

Jon



--
Apps built with the Adobe(R) Flex(R) framework and Flex Builder(TM) are
powering Web 2.0 with engaging, cross-platform capabilities. Quickly and
easily build your RIAs with Flex Builder, the Eclipse(TM)based development
software that enables intelligent coding and step-through debugging.
Download the free 60 day trial. http://p.sf.net/sfu/www-adobe-com
___
Flightgear-devel mailing list
Flightgear-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/flightgear-devel


Re: [Flightgear-devel] XML schema files for FlightGear

2009-03-13 Thread Torsten Dreyer
 This is a good thing to do. I've been trying to keep current JSBSim schema
 and XSL transformation documents up to date. I use OxygenXML as an editor.
 Which one do you use?
OxygenXML, too. It's the only one I found/know, that runs on linux.

Once the schema for the FlightGear config file is created, it should not be to 
much sweat to keep it in sync with the source. New elements don't show up 
every week. 
The time consuming task is building the schema. The JSBSim files follow some 
very strict rules, while the FlightGear config files are - well, sometimes 
quite flexible.

Torsten

--
Apps built with the Adobe(R) Flex(R) framework and Flex Builder(TM) are
powering Web 2.0 with engaging, cross-platform capabilities. Quickly and
easily build your RIAs with Flex Builder, the Eclipse(TM)based development
software that enables intelligent coding and step-through debugging.
Download the free 60 day trial. http://p.sf.net/sfu/www-adobe-com
___
Flightgear-devel mailing list
Flightgear-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/flightgear-devel