subject:"svn commit\\\\\\\: r1734070 \\\\\\\- \\\\\\\/maven\\\\\\\/site\\\\\\\/trunk\\\\\\\/content\\\\\\\/apt\\\\\\\/guides\\\\\\\/mini\\\\\\\/guide\\\\\\\-using\\\\\\\-toolchains.apt"

Re: svn commit: r1734070 - /maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt

2016-03-14 Thread Michael Osipov


Am 2016-03-12 um 13:11 schrieb Hervé BOUTEMY:

thank you Lukas and Dennis for your feedback
in a wiki in general, like Confluence, both creation and last updated date are
displayed: IMHO, both can be useful


I did some investigations:
4. Doxia Sitetools SiteRenderer [4] says "dateCreation The date specified in
the source document, in the format "MMdd""


I have always assumed this to be a creation date as defined by the site 
context. Beware, the date format is not basic ISO date but an extended 
one in the source document. You have even improved the code/error 
message. The basic date is added to the Velocity context for internal 
use and is up for deprecation since 1.7 anyway.


Michael


-
To unsubscribe, e-mail: dev-unsubscr...@maven.apache.org
For additional commands, e-mail: dev-h...@maven.apache.org

Re: svn commit: r1734070 - /maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt

2016-03-12 Thread Hervé BOUTEMY

thank you Lukas and Dennis for your feedback
in a wiki in general, like Confluence, both creation and last updated date are 
displayed: IMHO, both can be useful


I did some investigations:

1. Doxia Sink API just tells "date" [1] without any hint on which one

2. APT does the same [2]

3. xdoc in its xsd [3] says "Optional creation/last updated date for the 
document element": hehe, do what you want :)

4. Doxia Sitetools SiteRenderer [4] says "dateCreation  The date specified in 
the source document, in the format "MMdd""


IMHO, there is an issue: the most clear definition is in SiteRenderer, with 
the variable named "dateCreation"
But it is against our current use, which is more "last modified"

Should we rename the variable in SiteRenderer to "lastModifiedDate" (and 
update Sink API and every other place)?

notice: this date is not really visible in rendered documents, nor is it 
available in reports for example.
Then I don't think we're causing strong issue: we're just stopping not being 
clear

Regards,

Hervé


[1] 
http://maven.apache.org/doxia/doxia/doxia-sink-api/apidocs/org/apache/maven/doxia/sink/Sink.html#date()

[2] http://maven.apache.org/doxia/references/apt-format.html#Title

[3] http://maven.apache.org/xsd/xdoc-2.0.xsd

[4] 
http://maven.apache.org/doxia/doxia-sitetools-archives/doxia-sitetools-1.3/doxia-site-renderer/

Le samedi 12 mars 2016 10:50:48 Dennis Lundberg a écrit :
> Hi,
> 
> I've always used it as an update date. From a user/reader point of view
> that is the most interesting thing to know.
> 
> Den 9 mar 2016 08:28 skrev "Hervé BOUTEMY" :
> > question to old Doxia developers: is date in title of a Doxia source file
> > expected to be *creation* or *update* date
> > 
> > since it seems we use this field inconsistently for these 2 purposes,
> > depending on who and when does an update
> > 
> > what is it intended to represent precisely?
> > in apt format doc [1], there is documentation about the format but not
> > about
> > which date it is...
> > 
> > 
> > Regards,
> > 
> > Hervé
> > 
> > 
> > [1] http://maven.apache.org/doxia/references/apt-format.html#Title
> > 
> > Le mardi 8 mars 2016 13:06:31 denn...@apache.org a écrit :
> > > Author: dennisl
> > > Date: Tue Mar  8 13:06:31 2016
> > > New Revision: 1734070
> > > 
> > > URL: http://svn.apache.org/viewvc?rev=1734070=rev
> > > Log:
> > > Update links to ex-codehaus plugins which are now at mojohaus.
> > > 
> > > Modified:
> > > maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt
> > > 
> > > Modified:
> > 
> > > maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt URL:
> > http://svn.apache.org/viewvc/maven/site/trunk/content/apt/guides/mini/guid
> > e
> > 
> > > -using-toolchains.apt?rev=1734070=1734069=1734070=diff
> > 
> > ==
> > =
> > 
> > > === ---
> > 
> > maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt
> > 
> > > (original) +++
> > > maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt Tue
> > 
> > Mar
> > 
> > >  8 13:06:31 2016 @@ -5,7 +5,7 @@
> > >  
> > >   Dennis Lundberg
> > >   Karl Heinz Marbaise
> > >   --
> > > 
> > > - 2015-06-12
> > > + 2016-03-08
> > > 
> > >   --
> > >  
> > >  ~~ Licensed to the Apache Software Foundation (ASF) under one
> > > 
> > > @@ -59,15 +59,15 @@ Guide to Using Toolchains
> > 
> > *-*---
> > -
> > 
> > --+-+-
> > --> 
> > > -+
> > > 
> > >  | jdk |
> > >  | <<<{{{/plugins/maven-surefire-plugin/}maven-surefire-plugin}}>>>
> > >  | 
> > >  | | 2.5 | Apache Maven
> > 
> > *-*---
> > -
> > 
> > --+-+-
> > --> 
> > > -+ -| jdk |
> > > <<<{{{
> > 
> > http://mojo.codehaus.org/animal-sniffer-maven-plugin/}animal-sniffer->
> > maven-plugin}}>>> | 1.3 | Codehaus Mojo +| jdk
> > |> 
> > > <<<{{{
> > 
> > http://www.mojohaus.org/animal-sniffer/animal-sniffer-maven-plugin/}a
> > 
> > > nimal-sniffer-maven-plugin}}>>> | 1.3   | Codehaus Mojo
> > 
> > *-*---
> > -
> > 
> > --+-+-
> > --> 
> > > -+ -| jdk |
> > > <<<{{{
> > 
> > http://mojo.codehaus.org/cassandra-maven-plugin/}cassandra-maven-plug
> > 
> > > in}}>>>   | 0.7.0-1 | Codehaus Mojo +| jdk
> > > 
> > > <<<{{{
> > 
> > http://www.mojohaus.org/cassandra-maven-plugin/}cassandra-maven-plugi
> > 
> > > n}}>>>| 0.7.0-1 | Codehaus Mojo
> > 
> > *-*---
> >

Re: svn commit: r1734070 - /maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt

2016-03-12 Thread Dennis Lundberg

Hi,

I've always used it as an update date. From a user/reader point of view
that is the most interesting thing to know.
Den 9 mar 2016 08:28 skrev "Hervé BOUTEMY" :

> question to old Doxia developers: is date in title of a Doxia source file
> expected to be *creation* or *update* date
>
> since it seems we use this field inconsistently for these 2 purposes,
> depending on who and when does an update
>
> what is it intended to represent precisely?
> in apt format doc [1], there is documentation about the format but not
> about
> which date it is...
>
>
> Regards,
>
> Hervé
>
>
> [1] http://maven.apache.org/doxia/references/apt-format.html#Title
>
> Le mardi 8 mars 2016 13:06:31 denn...@apache.org a écrit :
> > Author: dennisl
> > Date: Tue Mar  8 13:06:31 2016
> > New Revision: 1734070
> >
> > URL: http://svn.apache.org/viewvc?rev=1734070=rev
> > Log:
> > Update links to ex-codehaus plugins which are now at mojohaus.
> >
> > Modified:
> > maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt
> >
> > Modified:
> > maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt URL:
> >
> http://svn.apache.org/viewvc/maven/site/trunk/content/apt/guides/mini/guide
> > -using-toolchains.apt?rev=1734070=1734069=1734070=diff
> >
> ===
> > === ---
> maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt
> > (original) +++
> > maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt Tue
> Mar
> >  8 13:06:31 2016 @@ -5,7 +5,7 @@
> >   Dennis Lundberg
> >   Karl Heinz Marbaise
> >   --
> > - 2015-06-12
> > + 2016-03-08
> >   --
> >
> >  ~~ Licensed to the Apache Software Foundation (ASF) under one
> > @@ -59,15 +59,15 @@ Guide to Using Toolchains
> >
> *-*
> >
> --+-+---
> > -+
> >  | jdk |
> >  | <<<{{{/plugins/maven-surefire-plugin/}maven-surefire-plugin}}>>>
> >  | | 2.5 | Apache Maven
> >
> *-*
> >
> --+-+---
> > -+ -| jdk |
> > <<<{{{
> http://mojo.codehaus.org/animal-sniffer-maven-plugin/}animal-sniffer->
> maven-plugin}}>>> | 1.3 | Codehaus Mojo +| jdk |
> > <<<{{{
> http://www.mojohaus.org/animal-sniffer/animal-sniffer-maven-plugin/}a
> > nimal-sniffer-maven-plugin}}>>> | 1.3   | Codehaus Mojo
> >
> *-*
> >
> --+-+---
> > -+ -| jdk |
> > <<<{{{
> http://mojo.codehaus.org/cassandra-maven-plugin/}cassandra-maven-plug
> > in}}>>>   | 0.7.0-1 | Codehaus Mojo +| jdk
>|
> > <<<{{{
> http://www.mojohaus.org/cassandra-maven-plugin/}cassandra-maven-plugi
> > n}}>>>| 0.7.0-1 | Codehaus Mojo
> >
> *-*
> >
> --+-+---
> > -+ -| jdk |
> > <<<{{{http://www.mojohaus.org/exec-maven-plugin/}exec-maven-plugin}}>>>
> > | 1.1.1   | Codehaus Mojo +| jdk
>  |
> > <<<{{{http://www.mojohaus.org/exec-maven-plugin/}exec-maven-plugin}}>>>
> >  | 1.1.1   | Codehaus Mojo
> >
> *-*
> >
> --+-+---
> > -+ -| jdk |
> > <<<{{{http://www.mojohaus.org/jdiff-maven-plugin/}jdiff-maven-plugin}
> }>>>
> > | 1.0-beta-1-SNAPSHOT | Codehaus Mojo +| jdk
>  |
> > <<<{{{http://www.mojohaus.org/jdiff-maven-plugin/}jdiff-maven-plugin}
> }>>>
> >  | 1.0-beta-1-SNAPSHOT | Codehaus Mojo
> >
> *-*
> >
> --+-+---
> > -+ -| jdk |
> > <<<{{{
> http://mojo.codehaus.org/keytool-maven-plugin/}keytool-maven-plugin}}
> > >>>   | 1.4 | Codehaus Mojo +| jdk
>|
> > <<<{{{
> http://www.mojohaus.org/keytool/keytool-maven-plugin/}keytool-maven-p
> > lugin}}>>>| 1.4 | Codehaus Mojo
> >
> *-*
> >
> --+-+---
> > -+
> >  | protobuf|
> >  | <<<{{{
> http://sergei-ivanov.github.io/maven-protoc-plugin/examples/protob
> >  | uf-toolchain.html}maven-protoc-plugin}}>>> | 0.3.2 | github
> >
>

Re: svn commit: r1734070 - /maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt

2016-03-08 Thread Lukas Theussl



Hi Herve,

just from intuition I would say it's the update date, but I don't think 
there is a formal definition/specification on the level of the sink API.


The only distinction between creation and update date that I remember is 
in the document MetaData (org.apache.maven.doxia.document.DocumentMeta).


HTH,
-Lukas


Am 09.03.2016 um 08:28 schrieb Hervé BOUTEMY:

question to old Doxia developers: is date in title of a Doxia source file
expected to be *creation* or *update* date

since it seems we use this field inconsistently for these 2 purposes,
depending on who and when does an update

what is it intended to represent precisely?
in apt format doc [1], there is documentation about the format but not about
which date it is...


Regards,

Hervé


[1] http://maven.apache.org/doxia/references/apt-format.html#Title

Le mardi 8 mars 2016 13:06:31 denn...@apache.org a écrit :

Author: dennisl
Date: Tue Mar  8 13:06:31 2016
New Revision: 1734070

URL: http://svn.apache.org/viewvc?rev=1734070=rev
Log:
Update links to ex-codehaus plugins which are now at mojohaus.

Modified:
 maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt

Modified:
maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt URL:
http://svn.apache.org/viewvc/maven/site/trunk/content/apt/guides/mini/guide
-using-toolchains.apt?rev=1734070=1734069=1734070=diff
===
=== --- maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt
(original) +++
maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt Tue Mar
  8 13:06:31 2016 @@ -5,7 +5,7 @@
   Dennis Lundberg
   Karl Heinz Marbaise
   --
- 2015-06-12
+ 2016-03-08
   --

  ~~ Licensed to the Apache Software Foundation (ASF) under one
@@ -59,15 +59,15 @@ Guide to Using Toolchains
  *-*
--+-+---
-+
  | jdk |
  | <<<{{{/plugins/maven-surefire-plugin/}maven-surefire-plugin}}>>>
  | | 2.5 | Apache Maven
  *-*
--+-+---
-+ -| jdk |
<<<{{{http://mojo.codehaus.org/animal-sniffer-maven-plugin/}animal-sniffer-> 
maven-plugin}}>>> | 1.3 | Codehaus Mojo +| jdk |
<<<{{{http://www.mojohaus.org/animal-sniffer/animal-sniffer-maven-plugin/}a
nimal-sniffer-maven-plugin}}>>> | 1.3   | Codehaus Mojo
*-*
--+-+---
-+ -| jdk |
<<<{{{http://mojo.codehaus.org/cassandra-maven-plugin/}cassandra-maven-plug
in}}>>>   | 0.7.0-1 | Codehaus Mojo +| jdk |
<<<{{{http://www.mojohaus.org/cassandra-maven-plugin/}cassandra-maven-plugi
n}}>>>| 0.7.0-1 | Codehaus Mojo
*-*
--+-+---
-+ -| jdk |
<<<{{{http://www.mojohaus.org/exec-maven-plugin/}exec-maven-plugin}}>>>
 | 1.1.1   | Codehaus Mojo +| jdk |
<<<{{{http://www.mojohaus.org/exec-maven-plugin/}exec-maven-plugin}}>>>
  | 1.1.1   | Codehaus Mojo
*-*
--+-+---
-+ -| jdk |
<<<{{{http://www.mojohaus.org/jdiff-maven-plugin/}jdiff-maven-plugin}}>>>
 | 1.0-beta-1-SNAPSHOT | Codehaus Mojo +| jdk |
<<<{{{http://www.mojohaus.org/jdiff-maven-plugin/}jdiff-maven-plugin}}>>>
  | 1.0-beta-1-SNAPSHOT | Codehaus Mojo
*-*
--+-+---
-+ -| jdk |
<<<{{{http://mojo.codehaus.org/keytool-maven-plugin/}keytool-maven-plugin}}

   | 1.4 | Codehaus Mojo +| jdk |

<<<{{{http://www.mojohaus.org/keytool/keytool-maven-plugin/}keytool-maven-p
lugin}}>>>| 1.4 | Codehaus Mojo
*-*
--+-+---
-+
  | protobuf|
  | <<<{{{http://sergei-ivanov.github.io/maven-protoc-plugin/examples/protob
  | uf-toolchain.html}maven-protoc-plugin}}>>> | 0.3.2 | github
  *-*
--+-+---
-+

Re: svn commit: r1734070 - /maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt

2016-03-08 Thread Hervé BOUTEMY

question to old Doxia developers: is date in title of a Doxia source file 
expected to be *creation* or *update* date

since it seems we use this field inconsistently for these 2 purposes, 
depending on who and when does an update

what is it intended to represent precisely?
in apt format doc [1], there is documentation about the format but not about 
which date it is...


Regards,

Hervé


[1] http://maven.apache.org/doxia/references/apt-format.html#Title

Le mardi 8 mars 2016 13:06:31 denn...@apache.org a écrit :
> Author: dennisl
> Date: Tue Mar  8 13:06:31 2016
> New Revision: 1734070
> 
> URL: http://svn.apache.org/viewvc?rev=1734070=rev
> Log:
> Update links to ex-codehaus plugins which are now at mojohaus.
> 
> Modified:
> maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt
> 
> Modified:
> maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt URL:
> http://svn.apache.org/viewvc/maven/site/trunk/content/apt/guides/mini/guide
> -using-toolchains.apt?rev=1734070=1734069=1734070=diff
> ===
> === --- maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt
> (original) +++
> maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt Tue Mar
>  8 13:06:31 2016 @@ -5,7 +5,7 @@
>   Dennis Lundberg
>   Karl Heinz Marbaise
>   --
> - 2015-06-12
> + 2016-03-08
>   --
> 
>  ~~ Licensed to the Apache Software Foundation (ASF) under one
> @@ -59,15 +59,15 @@ Guide to Using Toolchains
>  *-*
> --+-+---
> -+
>  | jdk |
>  | <<<{{{/plugins/maven-surefire-plugin/}maven-surefire-plugin}}>>>
>  | | 2.5 | Apache Maven
>  *-*
> --+-+---
> -+ -| jdk |
> <<<{{{http://mojo.codehaus.org/animal-sniffer-maven-plugin/}animal-sniffer-> 
> maven-plugin}}>>> | 1.3 | Codehaus Mojo +| jdk |
> <<<{{{http://www.mojohaus.org/animal-sniffer/animal-sniffer-maven-plugin/}a
> nimal-sniffer-maven-plugin}}>>> | 1.3   | Codehaus Mojo
> *-*
> --+-+---
> -+ -| jdk |
> <<<{{{http://mojo.codehaus.org/cassandra-maven-plugin/}cassandra-maven-plug
> in}}>>>   | 0.7.0-1 | Codehaus Mojo +| jdk |
> <<<{{{http://www.mojohaus.org/cassandra-maven-plugin/}cassandra-maven-plugi
> n}}>>>| 0.7.0-1 | Codehaus Mojo
> *-*
> --+-+---
> -+ -| jdk |
> <<<{{{http://www.mojohaus.org/exec-maven-plugin/}exec-maven-plugin}}>>>
> | 1.1.1   | Codehaus Mojo +| jdk |
> <<<{{{http://www.mojohaus.org/exec-maven-plugin/}exec-maven-plugin}}>>>
>  | 1.1.1   | Codehaus Mojo
> *-*
> --+-+---
> -+ -| jdk |
> <<<{{{http://www.mojohaus.org/jdiff-maven-plugin/}jdiff-maven-plugin}}>>>  
> | 1.0-beta-1-SNAPSHOT | Codehaus Mojo +| jdk |
> <<<{{{http://www.mojohaus.org/jdiff-maven-plugin/}jdiff-maven-plugin}}>>>  
>  | 1.0-beta-1-SNAPSHOT | Codehaus Mojo
> *-*
> --+-+---
> -+ -| jdk |
> <<<{{{http://mojo.codehaus.org/keytool-maven-plugin/}keytool-maven-plugin}}
> >>>   | 1.4 | Codehaus Mojo +| jdk |
> <<<{{{http://www.mojohaus.org/keytool/keytool-maven-plugin/}keytool-maven-p
> lugin}}>>>| 1.4 | Codehaus Mojo
> *-*
> --+-+---
> -+
>  | protobuf|
>  | <<<{{{http://sergei-ivanov.github.io/maven-protoc-plugin/examples/protob
>  | uf-toolchain.html}maven-protoc-plugin}}>>> | 0.3.2 | github
>  *-*
> --+-+---
> -+


-
To unsubscribe, e-mail: dev-unsubscr...@maven.apache.org
For additional commands, e-mail: dev-h...@maven.apache.org

Re: svn commit: r1734070 - /maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt

Re: svn commit: r1734070 - /maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt

Re: svn commit: r1734070 - /maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt

Re: svn commit: r1734070 - /maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt

Re: svn commit: r1734070 - /maven/site/trunk/content/apt/guides/mini/guide-using-toolchains.apt

5 matches

Site Navigation

Mail list logo

Footer information