You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@maven.apache.org by Hervé BOUTEMY <he...@free.fr> on 2008/08/03 22:20:34 UTC
[POLL] Default Value for Reports Output Encoding
Hi,
While working on "Report Encoding Configuration" proposal [0], 2 options were
discussed lately for default value [1]:
a) use fixed UTF-8 encoding
b) use same encoding as source files
Both options seem viable: choosing between them will be a question of taste.
Hence this poll: what is your preference?
Regards,
Hervé
[0] http://docs.codehaus.org/display/MAVEN/Reporting+Encoding+Configuration
[1]
http://www.nabble.com/Re%3A--VOTE--Release-Maven-Javadoc-Plugin-version-2.5-p18789937.html
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org
Re: [POLL] Default Value for Reports Output Encoding
Posted by Vincent Siveton <vi...@gmail.com>.
Hi Hervé,
IMHO, this survey should be also on user@
Cheers,
Vincent
2008/8/3 Hervé BOUTEMY <he...@free.fr>:
> Hi,
>
> While working on "Report Encoding Configuration" proposal [0], 2 options were
> discussed lately for default value [1]:
>
> a) use fixed UTF-8 encoding
>
> b) use same encoding as source files
>
>
> Both options seem viable: choosing between them will be a question of taste.
> Hence this poll: what is your preference?
>
> Regards,
>
> Hervé
>
> [0] http://docs.codehaus.org/display/MAVEN/Reporting+Encoding+Configuration
>
> [1]
> http://www.nabble.com/Re%3A--VOTE--Release-Maven-Javadoc-Plugin-version-2.5-p18789937.html
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org
RE: [POLL] Default Value for Reports Output Encoding
Posted by Jörg Schaible <Jo...@Elsag-Solutions.com>.
a)
Hervé BOUTEMY wrote:
> Hi,
>
> While working on "Report Encoding Configuration" proposal [0], 2
> options were discussed lately for default value [1]:
>
> a) use fixed UTF-8 encoding
>
> b) use same encoding as source files
>
>
> Both options seem viable: choosing between them will be a question of
> taste. Hence this poll: what is your preference?
>
> Regards,
>
> Hervé
>
> [0]
> http://docs.codehaus.org/display/MAVEN/Reporting+Encoding+Conf
> iguration
>
> [1]
> http://www.nabble.com/Re%3A--VOTE--Release-Maven-Javadoc-Plugi
> n-version-2.5-p18789937.html
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org
Re: [POLL] Default Value for Reports Output Encoding
Posted by Hervé BOUTEMY <he...@free.fr>.
Le dimanche 03 août 2008, Jason van Zyl a écrit :
> What about the default system encoding?
At the moment, most plugins have a fixed value (ISO-8859-1 for site and jxr
plugins, UTF-8 for corbertura plugin)
Changing for default system encoding would be a build reproducibility
regression: not a good idea IMHO.
With option b), if a user his pom with platform encoding for source encoding,
he'll get platform encoding on reports too.
regards,
Hervé
>
> On 3-Aug-08, at 1:20 PM, Hervé BOUTEMY wrote:
> > Hi,
> >
> > While working on "Report Encoding Configuration" proposal [0], 2
> > options were
> > discussed lately for default value [1]:
> >
> > a) use fixed UTF-8 encoding
> >
> > b) use same encoding as source files
> >
> >
> > Both options seem viable: choosing between them will be a question
> > of taste.
> > Hence this poll: what is your preference?
> >
> > Regards,
> >
> > Hervé
> >
> > [0]
> > http://docs.codehaus.org/display/MAVEN/Reporting+Encoding+Configuration
> >
> > [1]
> > http://www.nabble.com/Re%3A--VOTE--Release-Maven-Javadoc-Plugin-version-2
> >.5-p18789937.html
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > For additional commands, e-mail: dev-help@maven.apache.org
>
> Thanks,
>
> Jason
>
> ----------------------------------------------------------
> Jason van Zyl
> Founder, Apache Maven
> jason at sonatype dot com
> ----------------------------------------------------------
>
> People develop abstractions by generalizing from concrete examples.
> Every attempt to determine the correct abstraction on paper without
> actually developing a running system is doomed to failure. No one
> is that smart. A framework is a resuable design, so you develop it by
> looking at the things it is supposed to be a design of. The more
> examples
> you look at, the more general your framework will be.
>
> -- Ralph Johnson & Don Roberts, Patterns for Evolving Frameworks
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org
Re: [POLL] Default Value for Reports Output Encoding
Posted by Benjamin Bentmann <be...@udo.edu>.
Jason van Zyl wrote:
> What about the default system encoding?
It would be part of the show for approach b). The effective encoding
would be determined by this chain:
report encoding -> source encoding -> system encoding
i.e. if report output encoding is not specified, fallback to source file
encoding, if that is also not specified, fallback to system default
encoding.
Benjamin
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org
Re: [POLL] Default Value for Reports Output Encoding
Posted by Jason van Zyl <ja...@maven.org>.
What about the default system encoding?
On 3-Aug-08, at 1:20 PM, Hervé BOUTEMY wrote:
> Hi,
>
> While working on "Report Encoding Configuration" proposal [0], 2
> options were
> discussed lately for default value [1]:
>
> a) use fixed UTF-8 encoding
>
> b) use same encoding as source files
>
>
> Both options seem viable: choosing between them will be a question
> of taste.
> Hence this poll: what is your preference?
>
> Regards,
>
> Hervé
>
> [0] http://docs.codehaus.org/display/MAVEN/Reporting+Encoding+Configuration
>
> [1]
> http://www.nabble.com/Re%3A--VOTE--Release-Maven-Javadoc-Plugin-version-2.5-p18789937.html
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
>
Thanks,
Jason
----------------------------------------------------------
Jason van Zyl
Founder, Apache Maven
jason at sonatype dot com
----------------------------------------------------------
People develop abstractions by generalizing from concrete examples.
Every attempt to determine the correct abstraction on paper without
actually developing a running system is doomed to failure. No one
is that smart. A framework is a resuable design, so you develop it by
looking at the things it is supposed to be a design of. The more
examples
you look at, the more general your framework will be.
-- Ralph Johnson & Don Roberts, Patterns for Evolving Frameworks
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org
Re: [POLL] Default Value for Reports Output Encoding
Posted by Stephen Connolly <st...@gmail.com>.
This is my objection to basing it on the source encoding.
My preference is to pick output encoding as UTF-8 with a simple means to
change it. Source encoding is a different matter. Some source files should
never be UTF-8 encoded and yet the output should not be encoded in the same
encoding...
I vote A
On Sun, Aug 3, 2008 at 11:29 PM, Brett Porter <br...@apache.org> wrote:
> If there is a good way to make it work, the source files sounds "best" as
> it is reproducible and gives a default that should work in most instances.
> However, I think there are some reports that would have multiple source
> files, and they could be of mixed encodings, right? If that would be a
> problem, then selecting UTF-8 might be better.
>
> - Brett
>
>
> On 04/08/2008, at 6:20 AM, Hervé BOUTEMY wrote:
>
> Hi,
>>
>> While working on "Report Encoding Configuration" proposal [0], 2 options
>> were
>> discussed lately for default value [1]:
>>
>> a) use fixed UTF-8 encoding
>>
>> b) use same encoding as source files
>>
>>
>> Both options seem viable: choosing between them will be a question of
>> taste.
>> Hence this poll: what is your preference?
>>
>> Regards,
>>
>> Hervé
>>
>> [0]
>> http://docs.codehaus.org/display/MAVEN/Reporting+Encoding+Configuration
>>
>> [1]
>>
>> http://www.nabble.com/Re%3A--VOTE--Release-Maven-Javadoc-Plugin-version-2.5-p18789937.html
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
>> For additional commands, e-mail: dev-help@maven.apache.org
>>
>>
> --
> Brett Porter
> brett@apache.org
> http://blogs.exist.com/bporter/
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
>
>
Re: [POLL] Default Value for Reports Output Encoding
Posted by Brett Porter <br...@apache.org>.
If there is a good way to make it work, the source files sounds "best"
as it is reproducible and gives a default that should work in most
instances. However, I think there are some reports that would have
multiple source files, and they could be of mixed encodings, right? If
that would be a problem, then selecting UTF-8 might be better.
- Brett
On 04/08/2008, at 6:20 AM, Hervé BOUTEMY wrote:
> Hi,
>
> While working on "Report Encoding Configuration" proposal [0], 2
> options were
> discussed lately for default value [1]:
>
> a) use fixed UTF-8 encoding
>
> b) use same encoding as source files
>
>
> Both options seem viable: choosing between them will be a question
> of taste.
> Hence this poll: what is your preference?
>
> Regards,
>
> Hervé
>
> [0] http://docs.codehaus.org/display/MAVEN/Reporting+Encoding+Configuration
>
> [1]
> http://www.nabble.com/Re%3A--VOTE--Release-Maven-Javadoc-Plugin-version-2.5-p18789937.html
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
>
--
Brett Porter
brett@apache.org
http://blogs.exist.com/bporter/
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org