Re: DJGPP documentation updates

[Ozkan Sezer (sezeroz@gmail.com) [via djgpp@delorie.com]]

On 2/14/24, Pali <pa...@pali.im> wrote:
> Hello,
>
> I figured out that you are one of the last contributors to the DJGPP
> project. I would like to ask, what is the state of the DJGPP project?
> It is still developed or it is not active anymore?
>
> I have some changes for DJGPP documentation and if the DJGPP project is
> still active I can send you documentation file diffs. Please let me know
> if you (or somebody else) would like to see them.

This must be asked / discussed on the djgpp mailing list: Added to CC.

[DJ Delorie]

> On 2/14/24, Pali <pa...@pali.im> wrote:
>> what is the state of the DJGPP project?

IMHO DJGPP is in "very long term stable maintenance mode". I mean, it's
not like MS-DOS is still changing, right?

>> It is still developed or it is not active anymore?

There are a few who continue to work on it, mostly maintaining ports and
builds. Activity is very low but hasn't stopped yet.

[Eli Zaretskii (eliz@gnu.org) [via djgpp@delorie.com]]

> From: "Ozkan Sezer (sez...@gmail.com) [via dj...@delorie.com]" <dj...@delorie.com>
> Date: Wed, 14 Feb 2024 03:27:00 +0300
> Cc: djgpp <dj...@delorie.com>

Can you tell what kind of documentation changes you are talking about?

[Eli Zaretskii (eliz@gnu.org) [via djgpp@delorie.com]]

> Date: Sat, 17 Feb 2024 16:52:10 +0100
> From: Pali <pa...@pali.im>
> Cc: dj...@delorie.com

> Hello, many thanks for all replies. Here is one simple change:
>
> --- src/libc/dpmi/api/d0401.txh
> +++ src/libc/dpmi/api/d0401.txh
> @@ -14,8 +14,8 @@ Please refer to the DPMI Specification (@pxref{DPMI Specification})
> for details on DPMI function call operation. Also see
> the DPMI Overview (@pxref{DPMI Overview}) for general information.
>
> -DPMI function AX = 0x0401 (DPMI 1.0 only). Not supported by CWSDPMI and
> -Windows.
> +DPMI function AX = 0x0401 (DPMI 1.0 only). Supported by CWSDPMI v5+,
> +but not by Windows.

Such changes are, of course, welcome. So how about posting them here,
and let people review and comment? Then we can install the parts that
look useful.

Thanks.

[Eli Zaretskii (eliz@gnu.org) [via djgpp@delorie.com]]

> Date: Sat, 17 Feb 2024 22:55:43 +0100

> From: Pali <pa...@pali.im>
> Cc: dj...@delorie.com
>

> > Such changes are, of course, welcome. So how about posting them here,
> > and let people review and comment? Then we can install the parts that
> > look useful.
> >
> > Thanks.
>

> Ok, here is another simple change for web documentation. Text
> "Capability not supported" is rendered above the HTML table. I have not
> found where is the source file, so I'm writing diff against web URL:
>
> --- https://www.delorie.com/djgpp/doc/dpmi/api/310508.html
> +++ https://www.delorie.com/djgpp/doc/dpmi/api/310508.html
> @@ -53,8 +53,8 @@ AX = <a href="errors.html">error cod

DJ, who and how maintains the Web docs?

[DJ Delorie]

Eli Zaretskii <el...@gnu.org> writes:
> DJ, who and how maintains the Web docs?

Me. Patch applied. Thanks!

[Eli Zaretskii (eliz@gnu.org) [via djgpp@delorie.com]]

> Date: Sun, 18 Feb 2024 11:35:11 +0100

> From: Pali <pa...@pali.im>
> Cc: dj...@delorie.com
>

> I'm sending another simple documentation change. In documentation for
> getting and setting attributes is written wrong name of the structure
> field in which is stored number pages.
>
> --- src/libc/dpmi/api/d0506.txh
> +++ src/libc/dpmi/api/d0506.txh
> @@ -20,7 +20,7 @@ not by Windows.
> This function retrieves the attributes of a number of pages. Pass the
> handle in @code{@var{info}->handle}, offset of first page (relative to
> start of block) in @code{@var{info}->address}, and number of pages in
> -@code{@var{info}->count}. The buffer @var{buffer} gets filled in with
> +@code{@var{info}->size}. The buffer @var{buffer} gets filled in with
> the attributes. For each page, a 16-bit attribute word in @var{buffer}
> defines the attributes of that page as follows:
>
> --- src/libc/dpmi/api/d0507.txh
> +++ src/libc/dpmi/api/d0507.txh
> @@ -20,7 +20,7 @@ not by Windows.
> This function sets attributes of a number of pages. Pass handle in
> @code{@var{info}->handle}, offset within block in
> @code{@var{info}->address}, and number of pages in
> -@code{@var{info}->count}. @var{buffer} points to an array of 16-bit
> +@code{@var{info}->size}. @var{buffer} points to an array of 16-bit
> words which specify the new attributes.
> @xref{__dpmi_get_page_attributes}, for the definition of the page
> attribute word.

Thanks, installed.