Home_greyopenFATE - openSUSE feature tracking > #305551
Dashboard | Search | Sign up | Login

Please login or register to be able to edit or vote this feature.

[Beta5] Document YaST RELAX NG Schema

Feature state

openSUSE-11.2
Rejected Information
openSUSE-11.3
Done

Description

According to Bug #455994 (comment #17) Lukas Ocilka suggested to create a FATE entry for this purpose.

Background:
The YaST DTD for
/etc/YaST2/firstboot.xml
and the like is outdated and lead to invalid XML files.

The DTD is/was rewritten as a RELAX NG Schema but elements, attributes, and attribute values are not documented yet.

User benefit:

  • Documented RNG schema supports XML editors in showing tool tips during the writing of a XML file.
  • WIth the help of XSLT a summary can be created automatically.
> reduces costs

Discussion


icons/user_comment.png L. O. wrote: (9 years ago)

The XML format of a control file is currently documented at http://forgeftp.novell.com/yast/doc/SL11.1/tdg/inst_in_general_chap.html (generated from manually written docbook file) nevertheless this means that it has to be done at two places at once: the RELAX NG schema and its documentation itself. Having the documentation source insite the RELAX NG schema would halp to keep the documentation in sync.

icons/user_comment.png T. S. wrote: (8 years ago)

Just for the record: See a documented example of a RELAX NG schema in http://gitorious.org/kiwi/kiwi/blobs/master/modules/KIWISchema.rnc

(This is the work that I've done with Marcus.)

icons/user_comment.png L. O. wrote: (8 years ago)

Documentation has been added to RNC file and it's properly atteched to generated RNG file. Some parts are still missing though, some might not be described enough - there is always some'can be done better'. So, please, file a bugreport if you find such issue.

Last change: 4 years ago
Voting
Score: 1
  • Negative: 0
  • Neutral: 1
  • Positive: 1
Tags
Feature Export
Application-xmlXML   Text-x-logPlaintext   PrinterPrint