API docs errata

classic Classic list List threaded Threaded
5 messages Options
Reply | Threaded
Open this post in threaded view
|

API docs errata

bobharner
Thiago,

I'm guessing you created the apidocs after bumping the version to 5.6.0 on
your desktop. That might explain why the published apidocs pages all say
5.6.0 at the top. Not a major problem, just wanted to let you know.

Also, there's an extraneous directory tree of yours in there left over from
Sep 2019:

https://tapestry.apache.org/5.4.5/coffeescript/home/thiago/

Again, not causing any real harm there.
Reply | Threaded
Open this post in threaded view
|

Re: API docs errata

Thiago H de Paula Figueiredo
On Sat, Mar 28, 2020 at 6:51 PM Bob Harner <[hidden email]> wrote:

> Thiago,
>

Hello!

Indeed, it looks like I've made a number of errors while doing the
documentation part of the release. Thanks for spotting them! I'll try to
fix them as soon as possible.


> I'm guessing you created the apidocs after bumping the version to 5.6.0 on
> your desktop. That might explain why the published apidocs pages all say
> 5.6.0 at the top. Not a major problem, just wanted to let you know.
> Also, there's an extraneous directory tree of yours in there left over from
> Sep 2019:
>
> https://tapestry.apache.org/5.4.5/coffeescript/home/thiago/
>
> Again, not causing any real harm there.
>


--
Thiago
Reply | Threaded
Open this post in threaded view
|

Re: API docs errata

bobharner
Thiago,

If you do end up recreating the javadoc pages, here's a tiny little
patch to tapestry-javadoc/build.gradle to fix the version numbers at
the bottom of the javadoc pages. I'd commit it now except I'm having
Apache password problems all of a sudden:

diff --git a/build.gradle b/build.gradle
index 30469c5..8898557 100755
--- a/build.gradle
+++ b/build.gradle
@@ -327,6 +327,7 @@ task aggregateJavadoc(type: Javadoc) {
     destinationDir file("$buildDir/documentation/javadocs")

     def tapestryStylesheet = file("src/javadoc/stylesheet7.css")
+    int thisYear = java.time.Year.now().getValue()

     configure(options) {
         splitIndex true
@@ -335,7 +336,7 @@ task aggregateJavadoc(type: Javadoc) {
         windowTitle "Tapestry API - ${project.version}"
         header "Tapestry API - ${project.version}"
         docTitle "Tapestry API - ($project.version)"
-        bottom '${project.version} - Copyright &copy; 2003-2015 <a
href="http://tapestry.apache.org">The Apache Software Foundation</a>.'
+        bottom "${project.version} - Copyright &copy;
2003-${thisYear} <a href=\"http://tapestry.apache.org/\">The Apache
Software Foundation</a>."
         use = true // 'use' seems to be a reserved word for the DSL
         links "https://docs.oracle.com/javase/8/docs/api/"
         links "https://docs.oracle.com/javaee/7/api/"

On Mon, Mar 30, 2020 at 10:03 AM Thiago H. de Paula Figueiredo
<[hidden email]> wrote:

>
> On Sat, Mar 28, 2020 at 6:51 PM Bob Harner <[hidden email]> wrote:
>
> > Thiago,
> >
>
> Hello!
>
> Indeed, it looks like I've made a number of errors while doing the
> documentation part of the release. Thanks for spotting them! I'll try to
> fix them as soon as possible.
>
>
> > I'm guessing you created the apidocs after bumping the version to 5.6.0 on
> > your desktop. That might explain why the published apidocs pages all say
> > 5.6.0 at the top. Not a major problem, just wanted to let you know.
> > Also, there's an extraneous directory tree of yours in there left over from
> > Sep 2019:
> >
> > https://tapestry.apache.org/5.4.5/coffeescript/home/thiago/
> >
> > Again, not causing any real harm there.
> >
>
>
> --
> Thiago

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: API docs errata

bobharner
Thiago,

It looks like the SHA-256 checkum files were never committed for the
5.5.0 release. You created them for the 5.4.5 release last September
but not this time. You can see their absence at the bottom of
https://downloads.apache.org/tapestry/

Until today, the Downloads page had SHA-256 links on them but they
were pointing to the MD5 checksum files. I changed to "not available"
for now.

Is there any way you can commit those
apache-tapestry-5.5.0-bin.zip.sha256 and
apache-tapestry-5.5.0-sources.zip.sha256 files, if you have them?

This is step 7 at https://tapestry.apache.org/release-process.html

Also, the https://downloads.apache.org/tapestry/apache-tapestry-5.5.0-apidocs.zip
file is missing (and its corresponding checksum files).

Thanks!

On Mon, Mar 30, 2020 at 8:43 PM Bob Harner <[hidden email]> wrote:

>
> Thiago,
>
> If you do end up recreating the javadoc pages, here's a tiny little
> patch to tapestry-javadoc/build.gradle to fix the version numbers at
> the bottom of the javadoc pages. I'd commit it now except I'm having
> Apache password problems all of a sudden:
>
> diff --git a/build.gradle b/build.gradle
> index 30469c5..8898557 100755
> --- a/build.gradle
> +++ b/build.gradle
> @@ -327,6 +327,7 @@ task aggregateJavadoc(type: Javadoc) {
>      destinationDir file("$buildDir/documentation/javadocs")
>
>      def tapestryStylesheet = file("src/javadoc/stylesheet7.css")
> +    int thisYear = java.time.Year.now().getValue()
>
>      configure(options) {
>          splitIndex true
> @@ -335,7 +336,7 @@ task aggregateJavadoc(type: Javadoc) {
>          windowTitle "Tapestry API - ${project.version}"
>          header "Tapestry API - ${project.version}"
>          docTitle "Tapestry API - ($project.version)"
> -        bottom '${project.version} - Copyright &copy; 2003-2015 <a
> href="http://tapestry.apache.org">The Apache Software Foundation</a>.'
> +        bottom "${project.version} - Copyright &copy;
> 2003-${thisYear} <a href=\"http://tapestry.apache.org/\">The Apache
> Software Foundation</a>."
>          use = true // 'use' seems to be a reserved word for the DSL
>          links "https://docs.oracle.com/javase/8/docs/api/"
>          links "https://docs.oracle.com/javaee/7/api/"
>
> On Mon, Mar 30, 2020 at 10:03 AM Thiago H. de Paula Figueiredo
> <[hidden email]> wrote:
> >
> > On Sat, Mar 28, 2020 at 6:51 PM Bob Harner <[hidden email]> wrote:
> >
> > > Thiago,
> > >
> >
> > Hello!
> >
> > Indeed, it looks like I've made a number of errors while doing the
> > documentation part of the release. Thanks for spotting them! I'll try to
> > fix them as soon as possible.
> >
> >
> > > I'm guessing you created the apidocs after bumping the version to 5.6.0 on
> > > your desktop. That might explain why the published apidocs pages all say
> > > 5.6.0 at the top. Not a major problem, just wanted to let you know.
> > > Also, there's an extraneous directory tree of yours in there left over from
> > > Sep 2019:
> > >
> > > https://tapestry.apache.org/5.4.5/coffeescript/home/thiago/
> > >
> > > Again, not causing any real harm there.
> > >
> >
> >
> > --
> > Thiago

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: API docs errata

bobharner
I went ahead and committed the SHA-256 checksum file myself just now,
matching the binary already released. Thiago, as the release manager
for the 5.5.0 I recommend that you verify that the checksum value I
uploaded -- 565b1822b61f1a7655ec3bce77a9379334cc5067b95ccb7a2def98ef374ed11d
-- matches the SHA-256 checksum of the apache-tapestry-5.5.0-bin.zip
on your computer, if you still have it.

I'll also commit the SHA-256 checksum file for the sources zip file soon.

On Sat, May 2, 2020 at 3:42 PM Bob Harner <[hidden email]> wrote:

>
> Thiago,
>
> It looks like the SHA-256 checkum files were never committed for the
> 5.5.0 release. You created them for the 5.4.5 release last September
> but not this time. You can see their absence at the bottom of
> https://downloads.apache.org/tapestry/
>
> Until today, the Downloads page had SHA-256 links on them but they
> were pointing to the MD5 checksum files. I changed to "not available"
> for now.
>
> Is there any way you can commit those
> apache-tapestry-5.5.0-bin.zip.sha256 and
> apache-tapestry-5.5.0-sources.zip.sha256 files, if you have them?
>
> This is step 7 at https://tapestry.apache.org/release-process.html
>
> Also, the https://downloads.apache.org/tapestry/apache-tapestry-5.5.0-apidocs.zip
> file is missing (and its corresponding checksum files).
>
> Thanks!
>
> On Mon, Mar 30, 2020 at 8:43 PM Bob Harner <[hidden email]> wrote:
> >
> > Thiago,
> >
> > If you do end up recreating the javadoc pages, here's a tiny little
> > patch to tapestry-javadoc/build.gradle to fix the version numbers at
> > the bottom of the javadoc pages. I'd commit it now except I'm having
> > Apache password problems all of a sudden:
> >
> > diff --git a/build.gradle b/build.gradle
> > index 30469c5..8898557 100755
> > --- a/build.gradle
> > +++ b/build.gradle
> > @@ -327,6 +327,7 @@ task aggregateJavadoc(type: Javadoc) {
> >      destinationDir file("$buildDir/documentation/javadocs")
> >
> >      def tapestryStylesheet = file("src/javadoc/stylesheet7.css")
> > +    int thisYear = java.time.Year.now().getValue()
> >
> >      configure(options) {
> >          splitIndex true
> > @@ -335,7 +336,7 @@ task aggregateJavadoc(type: Javadoc) {
> >          windowTitle "Tapestry API - ${project.version}"
> >          header "Tapestry API - ${project.version}"
> >          docTitle "Tapestry API - ($project.version)"
> > -        bottom '${project.version} - Copyright &copy; 2003-2015 <a
> > href="http://tapestry.apache.org">The Apache Software Foundation</a>.'
> > +        bottom "${project.version} - Copyright &copy;
> > 2003-${thisYear} <a href=\"http://tapestry.apache.org/\">The Apache
> > Software Foundation</a>."
> >          use = true // 'use' seems to be a reserved word for the DSL
> >          links "https://docs.oracle.com/javase/8/docs/api/"
> >          links "https://docs.oracle.com/javaee/7/api/"
> >
> > On Mon, Mar 30, 2020 at 10:03 AM Thiago H. de Paula Figueiredo
> > <[hidden email]> wrote:
> > >
> > > On Sat, Mar 28, 2020 at 6:51 PM Bob Harner <[hidden email]> wrote:
> > >
> > > > Thiago,
> > > >
> > >
> > > Hello!
> > >
> > > Indeed, it looks like I've made a number of errors while doing the
> > > documentation part of the release. Thanks for spotting them! I'll try to
> > > fix them as soon as possible.
> > >
> > >
> > > > I'm guessing you created the apidocs after bumping the version to 5.6.0 on
> > > > your desktop. That might explain why the published apidocs pages all say
> > > > 5.6.0 at the top. Not a major problem, just wanted to let you know.
> > > > Also, there's an extraneous directory tree of yours in there left over from
> > > > Sep 2019:
> > > >
> > > > https://tapestry.apache.org/5.4.5/coffeescript/home/thiago/
> > > >
> > > > Again, not causing any real harm there.
> > > >
> > >
> > >
> > > --
> > > Thiago

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]