Re: [servlet-dev] References to old versions of the Spec

[Mark Thomas <markt@xxxxxxxxxx>]

On 14/02/2020 08:40, Stuart Douglas wrote:
> So are we agreed that we should:
> 
> 1) Drop the change log, and replace with a small list of changes since
> the Servlet 4.0 spec.
> 2) Drop references to old versions of the Servlet spec that talk about
> historical stuff while we are doing the javax -> jakarta rename?
> 3) Drop section 14.4 (the deployment descriptor duplication that was
> discussed in another thread)?

+1

Mark


> 
> I am very much in favour of 1) as we lost almost all formatting when the
> document was moved over (even the formatting that is there is often
> wrong), so to fix all the changelog formatting is a bit of work that
> does not really seem worthwhile. My formatting PR
> at  https://github.com/eclipse-ee4j/servlet-api/pull/306 does touch
> these sections (as I fixed all the section headers to get the TOC to be
> correct) so it would be good to get this merged before we make these
> changes to avoid conflicts.
> 
> Stuart
> 
> 
> On Fri, 14 Feb 2020 at 19:21, Greg Wilkins <gregw@xxxxxxxxxxx
> <mailto:gregw@xxxxxxxxxxx>> wrote:
> 
> 
>     Sorry, late to this discussion (on vacation)... but I support
>     simplification of the document (ie removing since references) and
>     just the maintenance of a changelog.
> 
>     cheers
> 
> 
>     On Mon, 10 Feb 2020 at 10:50, Mark Thomas <markt@xxxxxxxxxx
>     <mailto:markt@xxxxxxxxxx>> wrote:
> 
>         On 09/02/2020 22:33, Stuart Douglas wrote:
>         >
>         >
>         > On Sat, 8 Feb 2020, 9:31 pm Mark Thomas, <markt@xxxxxxxxxx
>         <mailto:markt@xxxxxxxxxx>
>         > <mailto:markt@xxxxxxxxxx <mailto:markt@xxxxxxxxxx>>> wrote:
>         >
>         >     On 03/02/2020 20:05, Stuart Douglas wrote:
>         >     >
>         >     >
>         >     > On Mon, 3 Feb 2020 at 23:18, Mark Thomas
>         <markt@xxxxxxxxxx <mailto:markt@xxxxxxxxxx>
>         >     <mailto:markt@xxxxxxxxxx <mailto:markt@xxxxxxxxxx>>
>         >     > <mailto:markt@xxxxxxxxxx <mailto:markt@xxxxxxxxxx>
>         <mailto:markt@xxxxxxxxxx <mailto:markt@xxxxxxxxxx>>>> wrote:
>         >     >
>         >     >     On 31/01/2020 18:37, Bill Shannon wrote:
>         >     >     > The history / change log should be removed, or rather
>         >     cleared out and
>         >     >     > added to going forward.
>         >     >
>         >     >     Just to clarify, do you mean this section should be
>         empty or
>         >     should it
>         >     >     contain a single line (assuming it is the only
>         change) that
>         >     says that,
>         >     >     compared to Servlet 4.0, the packages have been
>         renamed from
>         >     javax to
>         >     >     jakarta ?
>         >     >
>         >     >     If the answer to the above question is yes then I
>         guess we'd need
>         >     >     another line for "cosmetic only formatting/layout
>         changes as a
>         >     result of
>         >     >     importing the specification text"
>         >     >
>         >     >
>         >     > Do we really want to do that? It has been moved from one
>         system to
>         >     > another, so this would be a huge amount of work for and
>         I don't really
>         >     > see any value in it.
>         >
>         >     I don't understand the concern. Removing most of the
>         changelog content
>         >     and adding a couple of simple lines should be a trivial
>         amount of work
>         >     (it was for JSP anyway). Where do you see the "huge
>         amount" work coming
>         >     from?
>         >
>         >
>         > I misunderstood, I was thinking that there would be a
>         reference to every
>         > cosmetic change, rather than just a single line. I am going to
>         blame it
>         > on lack of sleep due to a new baby:-)
> 
>         No problem. Sorry my explanation wasn't clear. Glad we cleared
>         up the
>         confusion. I'll leave you to get some sleep ;)
> 
>         Cheers,
> 
>         Mark
>         _______________________________________________
>         servlet-dev mailing list
>         servlet-dev@xxxxxxxxxxx <mailto:servlet-dev@xxxxxxxxxxx>
>         To change your delivery options, retrieve your password, or
>         unsubscribe from this list, visit
>         https://www.eclipse.org/mailman/listinfo/servlet-dev
> 
> 
> 
>     -- 
>     Greg Wilkins <gregw@xxxxxxxxxxx <mailto:gregw@xxxxxxxxxxx>> CTO
>     http://webtide.com
>     _______________________________________________
>     servlet-dev mailing list
>     servlet-dev@xxxxxxxxxxx <mailto:servlet-dev@xxxxxxxxxxx>
>     To change your delivery options, retrieve your password, or
>     unsubscribe from this list, visit
>     https://www.eclipse.org/mailman/listinfo/servlet-dev
> 
> 
> _______________________________________________
> servlet-dev mailing list
> servlet-dev@xxxxxxxxxxx
> To change your delivery options, retrieve your password, or unsubscribe from this list, visit
> https://www.eclipse.org/mailman/listinfo/servlet-dev
>