[PATCH] Document non-8-bits-addressable support in NEWS

[PATCH] Document non-8-bits-addressable support in NEWS

[Simon Marchi]

I think it would be a good idea to document that gdb now has (basic)
support to read/write memory on architectures with non-8-bits memory.
Hopefully somebody will see it and say "Hey!  We can now (more easily)
port GDB to our strange DSP that has 32-bits-addressable memory!" and do
it.

gdb/ChangeLog:

	* NEWS: Document support for non-8-bits addressable memory.
---
 gdb/NEWS | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/gdb/NEWS b/gdb/NEWS
index 49c4a11..ed4d968 100644
--- a/gdb/NEWS
+++ b/gdb/NEWS
@@ -48,6 +48,11 @@ show remote multiprocess-extensions-packet
   target mon2000	mon2000 ROM monitor
   target ppcbug		PPCBUG ROM monitor for PowerPC
 
+* Support for reading/writing memory and extracting values on architectures
+  with non-8-bits-addressable memory.  A 16-bits-addressable memory, for
+  example, is one for which each address holds a 16-bits value (as opposed to
+  the more common 8-bits).
+
 *** Changes in GDB 7.10
 
 * Support for process record-replay and reverse debugging on aarch64*-linux*
-- 
2.1.4

Re: [PATCH] Document non-8-bits-addressable support in NEWS

[Eli Zaretskii]

> From: Simon Marchi <simon.marchi@ericsson.com>
> CC: Simon Marchi <simon.marchi@ericsson.com>
> Date: Wed, 26 Aug 2015 16:17:15 -0400
> 
> I think it would be a good idea to document that gdb now has (basic)
> support to read/write memory on architectures with non-8-bits memory.
> Hopefully somebody will see it and say "Hey!  We can now (more easily)
> port GDB to our strange DSP that has 32-bits-addressable memory!" and do
> it.

Thanks.

> gdb/ChangeLog:
> 
> 	* NEWS: Document support for non-8-bits addressable memory.
> ---
>  gdb/NEWS | 5 +++++
>  1 file changed, 5 insertions(+)
> 
> diff --git a/gdb/NEWS b/gdb/NEWS
> index 49c4a11..ed4d968 100644
> --- a/gdb/NEWS
> +++ b/gdb/NEWS
> @@ -48,6 +48,11 @@ show remote multiprocess-extensions-packet
>    target mon2000	mon2000 ROM monitor
>    target ppcbug		PPCBUG ROM monitor for PowerPC
>  
> +* Support for reading/writing memory and extracting values on architectures
> +  with non-8-bits-addressable memory.  A 16-bits-addressable memory, for
> +  example, is one for which each address holds a 16-bits value (as opposed to
> +  the more common 8-bits).

I think you should drop the second sentence, as it doesn't add any
useful information and is slightly inaccurate.  I think everyone will
understand what non-8-bits-addressable means.

Re: [PATCH] Document non-8-bits-addressable support in NEWS

[Simon Marchi]

On 15-08-26 10:37 PM, Eli Zaretskii wrote:
> I think you should drop the second sentence, as it doesn't add any
> useful information and is slightly inaccurate.  I think everyone will
> understand what non-8-bits-addressable means.

Right, thanks. Pushed with second sentence removed.


From fd2ae5d6a3a5c4007be45f9b2f325955ac316f36 Mon Sep 17 00:00:00 2001
From: Simon Marchi <simon.marchi@ericsson.com>
Date: Thu, 27 Aug 2015 09:30:00 -0400
Subject: [PATCH] Document non-8-bits addressable memory support in NEWS

I think it would be a good idea to document that gdb now has (basic)
support to read/write memory on architectures with non-8-bits memory.
Hopefully somebody will see it and say "Hey!  We can now (more easily)
port GDB to our strange DSP that has 32-bits-addressable memory!" and do
it.

gdb/ChangeLog:

	* NEWS: Document support for non-8-bits addressable memory.
---
 gdb/ChangeLog | 4 ++++
 gdb/NEWS      | 3 +++
 2 files changed, 11 insertions(+)

diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index d1b9ac9..cf55e14 100644
--- a/gdb/ChangeLog
+++ b/gdb/ChangeLog
@@ -1,3 +1,11 @@
+2015-08-27  Simon Marchi  <simon.marchi@ericsson.com>
+
+	* NEWS: Document support for non-8-bits addressable memory.
+
 2015-08-27  Pedro Alves  <palves@redhat.com>

 	* configure.ac: Remove AC_TYPE_SIGNAL call.
diff --git a/gdb/NEWS b/gdb/NEWS
index 49c4a11..5918f14 100644
--- a/gdb/NEWS
+++ b/gdb/NEWS
@@ -48,6 +48,9 @@ show remote multiprocess-extensions-packet
   target mon2000	mon2000 ROM monitor
   target ppcbug		PPCBUG ROM monitor for PowerPC

+* Support for reading/writing memory and extracting values on architectures
+  with non-8-bits-addressable memory.
+
 *** Changes in GDB 7.10

 * Support for process record-replay and reverse debugging on aarch64*-linux*
-- 
2.1.4

Re: [PATCH] Document non-8-bits-addressable support in NEWS

[Paul_Koning]

> On Aug 27, 2015, at 9:33 AM, Simon Marchi <simon.marchi@ericsson.com> wrote:
> 
> On 15-08-26 10:37 PM, Eli Zaretskii wrote:
>> I think you should drop the second sentence, as it doesn't add any
>> useful information and is slightly inaccurate.  I think everyone will
>> understand what non-8-bits-addressable means.
> 
> Right, thanks. Pushed with second sentence removed.
> 
> 
> From fd2ae5d6a3a5c4007be45f9b2f325955ac316f36 Mon Sep 17 00:00:00 2001
> From: Simon Marchi <simon.marchi@ericsson.com>
> Date: Thu, 27 Aug 2015 09:30:00 -0400
> Subject: [PATCH] Document non-8-bits addressable memory support in NEWS
> 
> I think it would be a good idea to document that gdb now has (basic)
> support to read/write memory on architectures with non-8-bits memory.
> Hopefully somebody will see it and say "Hey!  We can now (more easily)
> port GDB to our strange DSP that has 32-bits-addressable memory!" and do
> it.

Would it make sense to say what it can handle?  Multiples of 8?  Powers of 2?  Any number?  

"Any number" (like 27, or 60) is probably found only in historic machines, but I remember DSPs with 24 bit memory.

	paul

Re: [PATCH] Document non-8-bits-addressable support in NEWS

[Simon Marchi]

On 15-08-27 10:09 AM, Paul_Koning@Dell.com wrote:
> Would it make sense to say what it can handle?  Multiples of 8?  Powers of 2?  Any number?  
> 
> "Any number" (like 27, or 60) is probably found only in historic machines, but I remember DSPs with 24 bit memory.
> 
> 	paul

It's multiples of 8.  It would be good to add this precision I think.

What about adding: "Supported addressable sizes are multiples of 8 bytes." ?

Re: [PATCH] Document non-8-bits-addressable support in NEWS

[Simon Marchi]

On 15-08-27 10:26 AM, Simon Marchi wrote:
> On 15-08-27 10:09 AM, Paul_Koning@Dell.com wrote:
>> Would it make sense to say what it can handle?  Multiples of 8?  Powers of 2?  Any number?  
>>
>> "Any number" (like 27, or 60) is probably found only in historic machines, but I remember DSPs with 24 bit memory.
>>
>> 	paul
> 
> It's multiples of 8.  It would be good to add this precision I think.
> 
> What about adding: "Supported addressable sizes are multiples of 8 bytes." ?

Err, it should be "Supported addressable sizes are multiples of 8 bits.", not bytes.

Re: [PATCH] Document non-8-bits-addressable support in NEWS

[Paul_Koning]

> On Aug 27, 2015, at 11:04 AM, Simon Marchi <simon.marchi@ericsson.com> wrote:
> 
> On 15-08-27 10:26 AM, Simon Marchi wrote:
>> On 15-08-27 10:09 AM, Paul_Koning@Dell.com wrote:
>>> Would it make sense to say what it can handle?  Multiples of 8?  Powers of 2?  Any number?  
>>> 
>>> "Any number" (like 27, or 60) is probably found only in historic machines, but I remember DSPs with 24 bit memory.
>>> 
>>> 	paul
>> 
>> It's multiples of 8.  It would be good to add this precision I think.
>> 
>> What about adding: "Supported addressable sizes are multiples of 8 bytes." ?
> 
> Err, it should be "Supported addressable sizes are multiples of 8 bits.", not bytes.

Sounds good.  So I guess I won't be doing a cdc6600-gdb target handler.  :-)

	paul

Re: [PATCH] Document non-8-bits-addressable support in NEWS

[Eli Zaretskii]

> From: Simon Marchi <simon.marchi@ericsson.com>
> Date: Thu, 27 Aug 2015 11:04:50 -0400
> 
> On 15-08-27 10:26 AM, Simon Marchi wrote:
> > On 15-08-27 10:09 AM, Paul_Koning@Dell.com wrote:
> >> Would it make sense to say what it can handle?  Multiples of 8?  Powers of 2?  Any number?  
> >>
> >> "Any number" (like 27, or 60) is probably found only in historic machines, but I remember DSPs with 24 bit memory.
> >>
> >> 	paul
> > 
> > It's multiples of 8.  It would be good to add this precision I think.
> > 
> > What about adding: "Supported addressable sizes are multiples of 8 bytes." ?
> 
> Err, it should be "Supported addressable sizes are multiples of 8 bits.", not bytes.

I suggest to leave a single sentence reworded thusly:

  * Support for reading/writing memory and extracting values on architectures
    whose memory is addressable in units of any integral multiple of 8 bits.

Re: [PATCH] Document non-8-bits-addressable support in NEWS

[Simon Marchi]

On 15-08-27 11:39 AM, Eli Zaretskii wrote:
> I suggest to leave a single sentence reworded thusly:
> 
>   * Support for reading/writing memory and extracting values on architectures
>     whose memory is addressable in units of any integral multiple of 8 bits.

That sounds much better. I updated it:

From d63dd61e780e6354fe835d4a52aa9dac59ddfb05 Mon Sep 17 00:00:00 2001
From: Simon Marchi <simon.marchi@ericsson.com>
Date: Fri, 28 Aug 2015 15:35:47 -0400
Subject: [PATCH] Update NEWS entry about non-8-bits addressable memory

---
 gdb/ChangeLog | 4 ++++
 gdb/NEWS      | 2 +-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index 2b1fad9..71c0fd7 100644
--- a/gdb/ChangeLog
+++ b/gdb/ChangeLog
@@ -1,3 +1,7 @@
+2015-08-28  Simon Marchi  <simon.marchi@ericsson.com>
+
+	* NEWS: Update entry about non-8-bits addressable memory.
+
 2015-08-28  Ulrich Weigand  <uweigand@de.ibm.com>

 	Revert:
diff --git a/gdb/NEWS b/gdb/NEWS
index 5918f14..12282c7 100644
--- a/gdb/NEWS
+++ b/gdb/NEWS
@@ -49,7 +49,7 @@ show remote multiprocess-extensions-packet
   target ppcbug		PPCBUG ROM monitor for PowerPC

 * Support for reading/writing memory and extracting values on architectures
-  with non-8-bits-addressable memory.
+  whose memory is addressable in units of any integral multiple of 8 bits.

 *** Changes in GDB 7.10

-- 
2.1.4