Re: Release documentation missing for 2.23

[Markus Schuch <ma...@web.de>]

Hi Karl,

when i run `ant doc` on the release tag, i still get an error:

Forrest generates a linkmap for broken links

linkmap.html      BROKEN: Content is not allowed in prolog.

site\build\site\broken-links.xml contains

```
<broken-links>
   <link message="Content is not allowed in prolog.">linkmap.html</link>
</broken-links>
```

Do you know how to fix/debug this? I find no reference to a broken file
in the build log.

May be this is unrelated to the issues you found with the site
generation. I wanted to share this, just to be sure we generate the
documentation properly this time.

Markus


Am 29.11.2022 um 01:11 schrieb Karl Wright:
> The release doesn't contain the built documentation for some reason.  Not
> sure why.  Can't be fixed until a new release is built.
> Karl
>
>
> On Mon, Nov 28, 2022 at 7:08 PM Karl Wright <da...@gmail.com> wrote:
>
>> Sorry, misread.  The documentation is updated by unpacking the releases
>> and including the built documentation from each release in the appropriate
>> place.  I will check to see whether the documentation didn't properly
>> unpack or something during the build.
>>
>> Karl
>>
>>
>> On Mon, Nov 28, 2022 at 7:06 PM Karl Wright <da...@gmail.com> wrote:
>>
>>>
>>>
>>> On Mon, Nov 28, 2022 at 7:03 PM Karl Wright <da...@gmail.com> wrote:
>>>
>>>> This URL https://manifoldcf.apache.org/en_US/release-documentation.html
>>>> does not produce a 404 for me.  Are you sure?
>>>>
>>>> Karl
>>>>
>>>>
>>>> On Mon, Nov 28, 2022 at 6:06 PM Markus Schuch <ma...@web.de>
>>>> wrote:
>>>>
>>>>> The release documentation for ManifoldCF 2.23 is missing.
>>>>>
>>>>> The link at
>>>>> https://manifoldcf.apache.org/en_US/release-documentation.html
>>>>> produces 404.
>>>>>
>>>>> Do we have documentation how to properly release the documentation?
>>>>>
>>>>> Cheers
>>>>> Markus
>>>>>
>>>>
>

Re: Release documentation missing for 2.23

[Karl Wright <da...@gmail.com>]

Hi,
I'm in the middle of several work-related escalations so will not respond
until Sunday or Monday.  Apologies in advance.
Karl


On Fri, Dec 2, 2022 at 3:11 AM Markus Schuch <ma...@web.de> wrote:

> Hi Karl,
>
> when i run `ant doc` on the release tag, i still get an error:
>
> Forrest generates a linkmap for broken links
>
> linkmap.html      BROKEN: Content is not allowed in prolog.
>
> site\build\site\broken-links.xml contains
>
> ```
> <broken-links>
>    <link message="Content is not allowed in prolog.">linkmap.html</link>
> </broken-links>
> ```
>
> Do you know how to fix/debug this? I find no reference to a broken file
> in the build log.
>
> May be this is unrelated to the issues you found with the site
> generation. I wanted to share this, just to be sure we generate the
> documentation properly this time.
>
> Markus
>
>
> Am 29.11.2022 um 01:11 schrieb Karl Wright:
> > The release doesn't contain the built documentation for some reason.  Not
> > sure why.  Can't be fixed until a new release is built.
> > Karl
> >
> >
> > On Mon, Nov 28, 2022 at 7:08 PM Karl Wright <da...@gmail.com> wrote:
> >
> >> Sorry, misread.  The documentation is updated by unpacking the releases
> >> and including the built documentation from each release in the
> appropriate
> >> place.  I will check to see whether the documentation didn't properly
> >> unpack or something during the build.
> >>
> >> Karl
> >>
> >>
> >> On Mon, Nov 28, 2022 at 7:06 PM Karl Wright <da...@gmail.com> wrote:
> >>
> >>>
> >>>
> >>> On Mon, Nov 28, 2022 at 7:03 PM Karl Wright <da...@gmail.com>
> wrote:
> >>>
> >>>> This URL
> https://manifoldcf.apache.org/en_US/release-documentation.html
> >>>> does not produce a 404 for me.  Are you sure?
> >>>>
> >>>> Karl
> >>>>
> >>>>
> >>>> On Mon, Nov 28, 2022 at 6:06 PM Markus Schuch <ma...@web.de>
> >>>> wrote:
> >>>>
> >>>>> The release documentation for ManifoldCF 2.23 is missing.
> >>>>>
> >>>>> The link at
> >>>>> https://manifoldcf.apache.org/en_US/release-documentation.html
> >>>>> produces 404.
> >>>>>
> >>>>> Do we have documentation how to properly release the documentation?
> >>>>>
> >>>>> Cheers
> >>>>> Markus
> >>>>>
> >>>>
> >
>