Sorting sections in the help

[Regina Henschel <rb...@t-online.de>]

Hi all,

if you look for function IMSIN in the help, you get a page from source 
helpcontent2/sourc/text/scalc/01/04060116.xhp.

1.
When you look at that page in the help viewer you will notice, that the 
functions are not alphabetically sorted. This is because sorting has 
been disabled in https://issues.apache.org/ooo/show_bug.cgi?id=70462
But I do not notice any problem, if I enable it again. You can try it 
too. You need not to compile the source, but can edit the file 
main_transform.xsl directly. It is located in <instdir>/Basis/help
The section should read
<!-- SORT -->
<xsl:template match="sort" >
	<xsl:apply-templates><xsl:sort 
select="descendant::paragraph"/></xsl:apply-templates>
</xsl:template>
<xsl:template match="sort" mode="embedded">
	<xsl:apply-templates><xsl:sort 
select="descendant::paragraph"/></xsl:apply-templates>
</xsl:template>

So my question is, whether there still exists a reason not to enable 
sorting.

Are there problems in special languages?

2.
When sorting is enabled, you will notice, that the section containing 
the function IMABS is not on the correct place. The reason for this is 
an empty paragraph element at the start of that section in 04060116.xhp 
in line 49,50. Does anyone know, if I can simple delete it. Or does this 
element has a special purpose?

Kind regards
Regina

Re: Sorting sections in the help

[Ariel Constenla-Haile <ar...@apache.org>]

Hi Regina,

On Wed, May 30, 2012 at 09:29:11PM +0200, Regina Henschel wrote:
> Hi all,
> 
> if you look for function IMSIN in the help, you get a page from
> source helpcontent2/sourc/text/scalc/01/04060116.xhp.
> 
> 1.
> When you look at that page in the help viewer you will notice, that
> the functions are not alphabetically sorted. This is because sorting
> has been disabled in
> https://issues.apache.org/ooo/show_bug.cgi?id=70462
> But I do not notice any problem, if I enable it again. You can try
> it too. You need not to compile the source, but can edit the file
> main_transform.xsl directly. It is located in <instdir>/Basis/help
> The section should read
> <!-- SORT -->
> <xsl:template match="sort" >
> 	<xsl:apply-templates><xsl:sort
> select="descendant::paragraph"/></xsl:apply-templates>
> </xsl:template>
> <xsl:template match="sort" mode="embedded">
> 	<xsl:apply-templates><xsl:sort
> select="descendant::paragraph"/></xsl:apply-templates>
> </xsl:template>
> 
> So my question is, whether there still exists a reason not to enable
> sorting.
> 
> Are there problems in special languages?

I tested with Spanish, and there is no error output on the terminal, and
the sorting works fine.

That bug is from 2006, libxslt fixed several related bugs in the
meantime; just read the NEWS file in
libxslt/$OUT/misc/build/libxslt-1.1.26/NEWS


1.1.25: Sep 17 2009:

- xsl:sort lang support using the locale (Nick Wellnhofer and Roumen
  Petrov)
- big patch from  finishing xsl:sort lang support (Roumen Petrov)
- add xsl:sort lang support using the locale (Nick Wellnhofer)


It looks like that bug was fixed upstream.


Regards
-- 
Ariel Constenla-Haile
La Plata, Argentina