Mailinglist Archive: opensuse-updates (33 mails)

< Previous Next >
openSUSE-RU-2012:0788-1: Documentation update
openSUSE Recommended Update: Documentation update
______________________________________________________________________________

Announcement ID: openSUSE-RU-2012:0788-1
Rating: low
References: #703489 #706459 #706464 #706475 #706479 #708637
#758401 #763268
Affected Products:
openSUSE 12.1
______________________________________________________________________________

An update that has 8 recommended fixes can now be installed.

Description:

This update fixes the following issues for daps,
suse-xsl-stylesheets and opensuse-manuals_ru:

daps:
- Version 1.0.2 (Bugfix Release):
* Important:
- in order to avoid confusion with short options for
daps itself (such as -d for --docconfig and --draft), the
subcommands only support long options now. The following
short options for subcommands are no longer supported:
-c (use --comments)
-d (use --draft)
-f (use --file)
-m (use --meta)
-n (use --name)
-p (use --pretty)
-r (use --remarks)
-s (use --show)
- the only short option that will remain is -h (help)

* Bugfixes:
- added proper help texts for subcommands
- target warn-images did not work
- target missinggraphics did not show all missing images
- daps failed with a useless error message when $MAIN
was not well-formed. The fix produces a useful error
message now
- --remarks option did not work with DocBook stylesheets
- paths specified on the command line or the config
file had to be absolute. The fix now allows to also specify
relative paths for all configurable directories and files
- COMMENTS_STR, DRAFT_STR and REMARK_STR were not
correctly unset when one of these modes was not set on the
command line but implied by another mode (e.g. --meta). The
result was a wrong filename
- target webhelp-dir-name was missing
- draft.png was not shown in PDF/HTML draft builds when
using the DocBook Stylesheets
- Due to a variable name mismatch, the --name option
did not work properly
- target showvariable exited with an error if requested
variable was empty
- config options FOP_CONFIG and XEP_CONFIG were not
used. The fix renames them to FOP_CONFIG_FILE and
XEP_CONFIG_FILE - these variables are used in the wrapper
scripts
- FOP_WRAPPER and XEP_WRAPPER were not set correctly
when DAPSROOT was set
- disabled Permalink generation for PDFs (this is an
HTML-only feature)
- images were not cerrectly references for target jsp
- the DEF file was not correctly packaged in target
locdrop
- fixed webhelp target. Wildcards do not work in
classpath expression, resolved them with $(wildcard
$(firstword())
- Warning message "DEF file is missing" was issued for
targets that do not have a --def-file option
- targets package-html and package-pdf failed with an
error on desktop files generation
- target remaininggraphics always returned an empty list
- SVG to SVG conversions generated useless error
messages

* Stylesheets:
- removed obsolete stuff for @role=productname,
productnumber, or productnameref

* Documentation:
- Quick Start Guide: Finished
- User Guide: Significant additions, but still work in
progress
- Updated README.upgrade_from_susedoc_4.x

- Version 1.0:

* Bugfix:
- Use XEP/FOP wrapper scripts by default

- Version 1.0 RC5:

* Bugfix:
- Setting stack size for FOP to 512k in wrapper script,
otherwise builds on i586 fail during hyphenation

- Version 1.0 RC4:

* Bugfix:
- Not all links were dereferenced with --static

- Version 1.0 RC3:

* Bugfixes:
- Issuing hint on missing formatter scripts only when
verbosity is >= 1
- spec-file: Fixed typo on suse-xsl-stylesheet
'recommends python-xml' needs to be a general requirement
- fixed path to callouts and style images for FO


* Lots of minor documentation fixes/enhancements

- Version 1.0 RC2:

* Bugfixes:
- issue a hint rather than exiting when XEP/FOP_WRAPPER
do not exist
- daps_xslt/yelp/*.xsl was not installed by make install

- Version 1.0 RC1:

* Bugfixes:
- fixed minor package building issues
- inkscape always returns 0, even in case of an error.
Added a workaround, so daps now exits when an image
conversion with inkscape fails
- --main option should work now
- Fixed errors on setting the fallback stylesheets
- comments and remarks did not show up in the docs when
requested (again ;-(( ) - this is fixed now

* much better error handling - daps will now exit when
wrong paths or a non existing ROOTID are entered in the
user config file or the DC file

* significant enhancements to the Documentation
(Reference and Quickstart)

- Target for index generation had wrong ending (.idx
instead of .ind)
- Typo in Makefile caused wrong catalog entries
- showvariable now only shows the result to make it better
suited for script usage

- Version 1.0beta2:
* Bugfix:
- Finally found the correct solution for
adding/removing catalog entries in the spec file

* Enhancement: webhelp suppport

- Version 1.0beta1:

* Rebuild large parts to make DAPS
distribution-independent.
- rewrote Makefile for automake/autoconf => configure;
make; make install is now supported
- thorough cross-distribution testing is still needed,
basic tests have been run on RedHat, Debian and Ubuntu

* removal of custom stylesheets
- DAPS no longer uses the SUSE stylesheets as a
default. It even no longer contains the SUSE stylesheets -
they are now available as a separate package
(suse-xsl-stylesheets in Documentation:Tools).
- By default DAPS uses the generic DocBook stylesheets
now
- Custom stylesheets such as the SUSE stylesheets can be
used by specifying up to four parameters on the command
line/the config files:
* Styleroot:
- Directory containing the custom stylesheets. Must
have the same directory structure as the original DocBook
stylesheet root directory. Does _not_ need to contain
stylesheets for all output formats. If stylesheets are not
found, DAPS will automatically fall back to the DocBook
stylesheets.
- Variable: STYLEROOT
- Parameter: --styleroot
- Value: absolute path to directory
* Fallback styleroot
- Custom fallback styleroot. If DAPS cannot find
styles for the given output format, it will automatically
fall back to the DocBook stylesheets. This config option
will add a custom fallback directory with higher priority.
The DocBook stylesheets will remain as a last resort,
however.
- Variable: FALLBACK_STYLEROOT
- Parameter: --fb_styleroot
- Value: absolute path to directory
* CSS files:
- Specify CSS files for HTML and/or CSS. By default
no CSS file will be used.
- Variables: HTML_CSS, EPUB_CSS
- Parameter: --css for html and epub targets (daps
-d DC html--css CSS )
- Value: absolute path to file

* rewrote FOP formatter handling - both supported
formatters (FOP/XEP) are now controlled by the
following variables:
- *_WRAPPER (wrapper script, libexec/daps-fop,
libexec/daps-xep by default)
- *_CONFIG (xml config file, etc/daps/xep/xep-daps.xml
and etc/daps/fop/fop-daps.xml by default. A specific
fop-daps.xml is installed for RedHat and SUSE by default)
- *_OPTIONS (Command line options)

* renaming of parameters and variables
- In order to make parameters and variables
"self-speaking" the following has been renamed:
- File ENV-file to DC-file (doc config file)
- Variable BASE_DIR to DOC_DIR (doc dir) =>
Terminology!
- Variable DTDROOT to DAPSROOT (daps installation
directory)
- Variable FOP_TYPE to FORMATTER

- command line switch --fop to --formatter
- command line switch -e/--envfile has been renamed to
-d/--docconfig (-e/--envfile will still be supported)

* global parameter --base_dir no longer supported

- Instead of specifying --base_dir with daps, you now
need to specify a full path (either relative or absolute)
to the DC-file. However, the "magic" that automatically
tries to determine the path to a DC-file when you do not
specify a path or not even a DC file, still applies.
Therefore you only need to specify a valid path to the
DC-file in cases where you would have used --base_dir with
previous DAPS versions.

* --main parameter / MAIN

- Instead of calling daps with -d/--docconfig you can
also directly specify a MAIN with --main=PATH. You need to
specify a valid relative or absolute path. If you just
specify a file name, ./xml/$MAIN is automatically assumed.

* packaging

The former DAPS version has been split into two packages:
- daps
- suse-xsl-stylesheets (SUSE stylesheets, NovDOC DTD,
SUSE aspell wordlist)

* other DAPS changes since 0.9.2 in brief:
- stylesheet images have been moved to fit the
directory structure used in the original stylesheets
- new variable STYLEDEVEL which can be used when
developing stylesheets. STYLEDEVEL _always_ takes
precedence over STYLEROOT and can be set in $USER_CONFIG
- Rewrote handling of profiling variables PROFARCH,
PROFCONDITION, PROFVENDOR, PROFOS - all 4 are now fully
supported (formerly only PROFOS and PROFARCH were fully
supported)
- created catalog entry to resolve stylesheets in
daps_xslt
- daps init has been moved to a separate script
bin/daps-init
- each SUSE stylesheet file now contains a short
overview of purpose and parameters
- lots of stylesheet bugfixes
- license: GPL 2.0 or 3.0 at your choice
- fixed target man for man-page generation; man pages
are not gzip'ed by default (unless you specify --nogzip);
manpage subdirectories (man1, man2,...) are no longer
created by default, but can rather be enabled via the
--subdirs switch
- new parameter --check for target epub checks build
with epubcheck
- added very basic DocBook5 support (with xslt 1.0
stylesheets only) still a lot to do on this front
- Default HTML format is now XHTML 1.0 (instead of HTML
4.01). Use --html4 to generate HTML 4.01
- auto generate SUSE HTML4 stylesheets from XHTML
stylesheets
- binaries that are only called from withion make have
been moved to libexec/


suse-xsl-stylesheets:
- Initial update for this package
- Adjusted rnc/rng generation in order to allow a custom
novdocx.rng that defines start tags allowed
- Version 1.9.6.1:
- Added new SUSE logo from Scott Corfield
- Version 1.9.6:
- fo: Fixed xref to external target; use article title
instead of book title
- fo: Make formal titles float, but don't indent screen
(or other objects) Removed test for xep.extensions and
moved float=none and clear=both attributes to
fo/mode-object.title.markup.xsl (only needed for XEP)
- Version 1.9.5:
- removes suse aspell wordlist
- package is norach again
- Version 1.9.4:
- Replace Obsolete PI Mechanism for product names and
numbers Preliminary, need to test it
- Added setinfo in set for Novdoc DTD
- Version 1.9.3:
- Improve Space Between Formal Titles and Verbatim Text
- SUSE Branding: Quick Start Layout (I)
- SUSE Branding: Quick Start Layout (II)
- SUSE Branding: Stylesheets produce invalid HTML 4.01
Transitional
- bnc#703489: Problems with Tables (reported upstream)
- bnc#706459: Distance Between Page Number and Left/Right
Footer
- bnc#706464: Space Between Figure/Procedure XYZ and Title
- bnc#706475: Some Issues with Callouts
- bnc#706479: Line Break in ulink Elements
- bnc#708637: susedoc/daps stylesheets produce invalid
HTML 4.01 Transitional (Moved to Ticket#68)
- Version 1.9.2:
- fixed SGML catalog entry generation when updating the
package
- fixed path to admon graphics in fo stylesheets
- added svg admonition graphics for fo builds
- Fixed empty fo:table-cell with fo:block to make FOP
happy
- Added missing booktitlepage.color.logo parameter to fo
stylesheets
- Renamed obsolete dtdroot to styleroot in fo stylesheets
- fixed broken callout generation for XEP and FOP
* Added more flexibilty to flyer layout: headline url can
now be set per suse-quickstart pi with attribute url
- fixed %postun routine, so catalog entries only get
removed on a real package installation

- Improved webhelp
- Fixed Toc in PDF
- Installing aspell wordlist to libdir makes this package
architecture-specific
- Fixed installation procedure for aspell wordlist
- aspell wordlist is now installed in teh correct place
- fixed path to fo draft image in fo stylesheets
- aspell-en-huge only seems to be available on x86-64,
making it a recommendation
- Moved suse-aspell wordlist from daps to this package
- Moved images/admon/* and images/navig/* to images/ in
order to restore compatability to the original DocBook
stylesheets
- Use absolute images paths in .fo files
- Added Catalog entries for the URI to
/etc/xml/suse-catalog.xml
- Created general URI for SUSE XSLT Stylesheets
- More path fixes
- Fixed import paths for flyer and pocket
- Created fo subdirectories for flyer and pocket
- Includes must _not_ point to daps-xslt
- Added missing profiling stylesheet
- First stable version
- Stylesheet files were not packed
- Initial version of a seperate SUSE stylesheets package


opensuse-manuals_ru:
- 758401: Manuals translate update for 12.1
- fix license to be in spdx format
- Update help_admin.xml


Patch Instructions:

To install this openSUSE Recommended Update use YaST online_update.
Alternatively you can run the command listed for your product:

- openSUSE 12.1:

zypper in -t patch openSUSE-2012-341

To bring your system up-to-date, use "zypper patch".


Package List:

- openSUSE 12.1 (noarch):

daps-1.0.2-5.9
opensuse-kvm_ru-pdf-12.1.8762-3.6.1
opensuse-manuals_ru-12.1.8762-3.6.1
opensuse-reference_ru-pdf-12.1.8762-3.6.1
opensuse-security_ru-pdf-12.1.8762-3.6.1
opensuse-startup_ru-pdf-12.1.8762-3.6.1
opensuse-tuning_ru-pdf-12.1.8762-3.6.1
suse-xsl-stylesheets-1.9.6.2-2.3


References:

https://bugzilla.novell.com/703489
https://bugzilla.novell.com/706459
https://bugzilla.novell.com/706464
https://bugzilla.novell.com/706475
https://bugzilla.novell.com/706479
https://bugzilla.novell.com/708637
https://bugzilla.novell.com/758401
https://bugzilla.novell.com/763268


< Previous Next >
This Thread
  • No further messages