RTEMS / Documentation / Documentation

Go to Issues or Merge Requests


Issues

157 - Docs version.py on 6 needs updating

Id

157

State

closed

Type

ISSUE

Author

Chris Johns

Closed by

Chris Johns

Created

2026-08-25T06:37:17.022Z

Closed

2026-10-31T16:46:04.398Z

Updated

2026-10-31T16:46:04.448Z

Milestone

6.3

Labels

doc

Link

https://gitlab.rtems.org/rtems/docs/rtems-docs/-/work_items/157

Merges

0

Summary

Building a release set of docs on 5 raises this error:

Traceback (most recent call last):
File "/opt/work/chris/rtems/releasing/rtems-release.git/5.4-rc2/ws-rtems-docs/rtems-docs-5.4-rc2/.waf3-2.0.19-1f3c580272b15a03d2566843c5fe872a/waflib/Scripting.py", line 119, in waf_entry_point
run_commands()
~~~~~~~~~~~~^^
File "/opt/work/chris/rtems/releasing/rtems-release.git/5.4-rc2/ws-rtems-docs/rtems-docs-5.4-rc2/.waf3-2.0.19-1f3c580272b15a03d2566843c5fe872a/waflib/Scripting.py", line 182, in run_commands
ctx=run_command(cmd_name)
File "/opt/work/chris/rtems/releasing/rtems-release.git/5.4-rc2/ws-rtems-docs/rtems-docs-5.4-rc2/.waf3-2.0.19-1f3c580272b15a03d2566843c5fe872a/waflib/Scripting.py", line 173, in run_command
ctx.execute()
~~~~~~~~~~~^^
File "/opt/work/chris/rtems/releasing/rtems-release.git/5.4-rc2/ws-rtems-docs/rtems-docs-5.4-rc2/.waf3-2.0.19-1f3c580272b15a03d2566843c5fe872a/waflib/Scripting.py", line 375, in execute
return execute_method(self)
File "/opt/work/chris/rtems/releasing/rtems-release.git/5.4-rc2/ws-rtems-docs/rtems-docs-5.4-rc2/.waf3-2.0.19-1f3c580272b15a03d2566843c5fe872a/waflib/Build.py", line 93, in execute
self.execute_build()
~~~~~~~~~~~~~~~~~~^^
File "/opt/work/chris/rtems/releasing/rtems-release.git/5.4-rc2/ws-rtems-docs/rtems-docs-5.4-rc2/.waf3-2.0.19-1f3c580272b15a03d2566843c5fe872a/waflib/Build.py", line 96, in execute_build
self.recurse([self.run_dir])
~~~~~~~~~~~~^^^^^^^^^^^^^^^^
File "/opt/work/chris/rtems/releasing/rtems-release.git/5.4-rc2/ws-rtems-docs/rtems-docs-5.4-rc2/.waf3-2.0.19-1f3c580272b15a03d2566843c5fe872a/waflib/Context.py", line 133, in recurse
user_function(self)
~~~~~~~~~~~~~^^^^^^
File "/opt/work/chris/rtems/releasing/rtems-release.git/5.4-rc2/ws-rtems-docs/rtems-docs-5.4-rc2/wscript", line 85, in build
ver_version, ver_date, ver_released = version.get(ctx, rtems_major_version)
~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/opt/work/chris/rtems/releasing/rtems-release.git/5.4-rc2/ws-rtems-docs/rtems-docs-5.4-rc2/common/version.py", line 135, in get
v = configparser.SafeConfigParser()
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
AttributeError: module 'configparser' has no attribute 'SafeConfigParser'. Did you mean: 'RawConfigParser'?

I guess pulling version.py from main would help if that version is also OK?

Author: Chris Johns

2026-08-25T06:37:17.148Z

cloned from #152

Author: Chris Johns

2026-08-25T06:37:31.989Z

added rtems#15 as parent item

Author: Chris Johns

2026-08-25T06:37:43.985Z

set status to In progress

Author: Chris Johns

2026-08-25T06:37:47.421Z

changed title from

Docs version.py on

5

needs updating

to

Docs version.py on

6

needs updating

Author: Chris Johns

2026-08-26T02:14:53.238Z

mentioned in merge request !257

Author: Chris Johns

2026-10-31T16:46:04.421Z

set status to Done

160 - Build warnings on 6 branch with Python 3.14

Id

160

State

closed

Type

ISSUE

Author

Chris Johns

Assignee(s)

Chris Johns

Closed by

Chris Johns

Created

2026-08-26T02:16:52.110Z

Closed

2026-10-31T16:45:51.483Z

Updated

2026-10-31T16:45:51.489Z

Milestone

6.3

Labels

doc

Link

https://gitlab.rtems.org/rtems/docs/rtems-docs/-/work_items/160

Merges

0

Summary

Running waf with Python 3.14 has these warnings:

./waf configure --prefix=/opt/src/rtems/docs/test
/opt/work/chris/rtems/docs/rtems-docs.git/common/waf.py:104: SyntaxWarning: "\\D" is an invalid escape sequence. Such sequences will not work in the future. Did you mean "\\\\D"? A raw string is also an option.


ver = tuple(map(int, re.split('[\\D]', version)))
/opt/work/chris/rtems/docs/rtems-docs.git/common/waf.py:111: SyntaxWarning: "\\D" is an invalid escape sequence. Such sequences will not work in the future. Did you mean "\\\\D"? A raw string is also an option.


ver = tuple(map(int, re.split('[\\D]', version)))
/opt/work/chris/rtems/docs/rtems-docs.git/common/latex.py:9: SyntaxWarning: "\\d" is an invalid escape sequence. Such sequences will not work in the future. Did you mean "\\\\d"? A raw string is also an option.


'\\documentclass[a4paper,11pt,english]{report}']

Author: Chris Johns

2026-08-26T02:16:52.232Z

cloned from #154

Author: Chris Johns

2026-08-26T02:17:03.952Z

added rtems#15 as parent item

Author: Chris Johns

2026-08-26T02:17:13.117Z

set status to In progress

Author: Chris Johns

2026-08-26T02:19:03.159Z

mentioned in merge request !258

Author: Chris Johns

2026-10-31T16:45:42.878Z

changed title from

Build warnings on

5

branch with Python 3.14

to

Build warnings on

6

branch with Python 3.14

Author: Chris Johns

2026-10-31T16:45:42.912Z

changed the description

Author: Chris Johns

2026-10-31T16:45:51.504Z

set status to Done

158 - Update waf on 6 branch

Id

158

State

closed

Type

ISSUE

Author

Chris Johns

Assignee(s)

Chris Johns

Closed by

Chris Johns

Created

2026-08-25T06:42:15.656Z

Closed

2026-10-31T16:33:43.610Z

Updated

2026-10-31T16:33:43.667Z

Milestone

6.3

Link

https://gitlab.rtems.org/rtems/docs/rtems-docs/-/work_items/158

Merges

0

We should use the latest which is 2.1.9.

Author: Chris Johns

2026-08-25T06:42:15.827Z

added rtems#15 as parent item

Author: Chris Johns

2026-08-25T06:42:15.920Z

set status to In progress

Author: Chris Johns

2026-08-25T06:42:16.063Z

assigned to @chris

Author: Chris Johns

2026-08-25T06:43:11.197Z

changed title from

Updat

r

e waf on 6 branch

to

Update waf on 6 branch

Author: Chris Johns

2026-08-25T06:45:16.124Z

mentioned in merge request !255

Author: Chris Johns

2026-08-26T14:22:14.355Z

mentioned in commit 2d65f5324eebad79b8a2fb4d90e16723c60efeae

Author: Chris Johns

2026-10-31T16:33:43.636Z

set status to Done

163 - The mdump example output is broken

Id

163

State

closed

Type

ISSUE

Author

Joel Sherrill

Assignee(s)

Joel Sherrill

Closed by

Chris Johns

Created

2026-09-10T15:22:51.959Z

Closed

2026-10-31T16:26:46.108Z

Updated

2026-10-31T16:26:46.113Z

Milestone

6.3

Labels

cpukit::shell, doc, rtems::shell

Link

https://gitlab.rtems.org/rtems/docs/rtems-docs/-/work_items/163

Merges

1

Summary

This work item is the same problem as #142 but for the 6 branch.

The mdump example output is broken. There are spaces missing between the address and the first byte.

SHLL [/] $ mdump 0x10000 32
0x0001000000 00 00 00 00 00 00 00-00 00 00 00 00 00 00 00 ................
0x0001001000 00 00 00 00 00 00 00-00 00 00 00 00 00 00 00 ................
SHLL [/] $ mdump 0x02000000 32
0x02000000A1 48 00 00 29 00 80 33-81 C5 22 BC A6 10 21 00 .H..)..3.."...!.
0x02000010A1 48 00 00 29 00 80 33-81 C5 22 BC A6 10 21 01 .H..)..3.."...!.
SHLL [/] $ mdump 0x02001000 32
0x0200100003 00 80 00 82 10 60 00-81 98 40 00 83 48 00 00 ......`.....H..
0x0200101084 00 60 01 84 08 A0 07-86 10 20 01 87 28 C0 02 ..`....... ..(..

Note the ten hex digits after each 0x (there should be only 8, followed by a SPACE character).

Steps to reproduce

  1. Surf to https://docs.rtems.org/docs/main/shell.html

  2. Scroll to mdump example

Author: Joel Sherrill

2026-09-10T15:22:52.084Z

set status to To do

Author: Joel Sherrill

2026-09-10T15:22:52.254Z

assigned to @joel

Author: Joel Sherrill

2026-09-10T15:23:49.429Z

marked as related to #142

Author: Joel Sherrill

2026-09-10T15:29:49.744Z

mentioned in merge request !261

Author: Joel Sherrill

2026-09-10T15:32:27.701Z

mentioned in merge request !262

Author: Joel Sherrill

2026-09-17T21:11:57.538Z

mentioned in commit joel/rtems@9cc928746e97b99c86af6a0829bb7fd5a0550137

Author: Joel Sherrill

2026-09-17T21:12:22.276Z

mentioned in merge request rtems/rtos/rtems!1495

Author: Chris Johns

2026-09-17T23:26:25.297Z

mentioned in commit joel/rtems@22b3389e262ce3325d2b919c2fa36f3de4398955

Author: Joel Sherrill

2026-09-18T17:00:41.466Z

removed the relation with #142

Author: Joel Sherrill

2026-09-18T17:01:23.518Z

marked this item as blocked by #142

Author: Joel Sherrill

2026-09-18T18:03:14.249Z

mentioned in commit joel/rtems@f61b3cf5f8ef7be14faa50e197aee15116518050

Author: Joel Sherrill

2026-09-18T18:04:50.774Z

mentioned in merge request rtems/rtos/rtems!1496

Author: Joel Sherrill

2026-09-18T18:06:37.691Z

mentioned in merge request rtems/rtos/rtems!1497

Author: Vijay Banerjee

2026-09-21T15:52:51.541Z

mentioned in commit joel/rtems@4a76fe06008c70dc40f01bce76071bdca612a52c

Author: Joel Sherrill

2026-10-08T22:54:14.525Z

mentioned in commit 0b1af0cdd8045845934e09f691102f06fe3d6708

Author: Chris Johns

2026-10-31T16:26:46.131Z

set status to Done

151 - Backport to 6 branch “user: Update remaining references to autotools”

Id

151

State

closed

Type

ISSUE

Author

Kinsey Moore

Assignee(s)

Kinsey Moore

Closed by

Kinsey Moore

Created

2026-07-31T14:55:23.643Z

Closed

2026-08-13T23:08:01.572Z

Updated

2026-08-13T23:08:01.663Z

Milestone

6.3

Link

https://gitlab.rtems.org/rtems/docs/rtems-docs/-/work_items/151

Merges

0

The following discussion from !249 should be addressed:

  • [] @opticron started a discussion:

    This needs a backport to 6 branch.

Author: Kinsey Moore

2026-07-31T14:55:23.824Z

added rtems#15 as parent item

Author: Kinsey Moore

2026-07-31T14:55:23.915Z

set status to To do

Author: Kinsey Moore

2026-07-31T14:55:24.017Z

assigned to @opticron

Author: Kinsey Moore

2026-07-31T16:24:18.736Z

mentioned in merge request !250

Author: Kinsey Moore

2026-07-31T17:20:05.841Z

set status to In progress

Author: Kinsey Moore

2026-08-13T23:08:01.635Z

set status to Done

143 - hexdump formats disks (opened)

Id

143

State

opened

Type

ISSUE

Author

Jens Schweikhardt

Created

2026-03-26T19:22:26.098Z

Updated

2026-09-09T19:23:57.732Z

Milestone

6.3

Link

https://gitlab.rtems.org/rtems/docs/rtems-docs/-/work_items/143

Merges

0

Summary

The docs erroneously (I hope) state that hexdump formats disks.

Steps to reproduce

Surf to https://docs.rtems.org/docs/main/shell.html section 4.1 Introduction, where is says “[hexdump] - format disks”

Author: Jens Schweikhardt

2026-03-26T19:22:26.212Z

set status to To do

Author: Joel Sherrill

2026-09-09T19:23:53.000Z

mentioned in merge request !260

Author: Joel Sherrill

2026-09-17T23:27:58.439Z

mentioned in commit 0ccc71f1d8033ea873e29faa28cfb759ba4f2ab0

93 - rtems-ver-minor set wrong in release? (opened)

Id

93

State

opened

Type

ISSUE

Author

Gedare Bloom

Assignee(s)

Gedare Bloom

Created

2025-02-27T16:51:58.067Z

Updated

2026-07-31T00:19:05.031Z

Milestone

6.3

Labels

doc, release

Link

https://gitlab.rtems.org/rtems/docs/rtems-docs/-/work_items/93

Merges

0

Summary

The minor number is 0 in the released docs for RTEMS 6.1

I’m not sure if this belongs to docs or release.

See for example https://docs.rtems.org/docs/6.1/user/start/sources.html#releases

@chris

Author: Gedare Bloom

2025-02-27T16:51:58.192Z

assigned to @gedare

Author: Chris Johns

2025-02-28T05:39:05.939Z

The 6.1 released docs can be found here https://ftp.rtems.org/pub/rtems/releases/6/6.1/docs/html/user/index.html and they look OK to me:

!`image.png <https://gitlab.rtems.org/-/project/uploads/0bd474ff5290a8c38a7b1783e937d97e/image.png>`_

@amar ?

Author: Chris Johns

2025-02-28T05:54:50.923Z

Checked docs.rtems.org and it also looks OK.

Author: Chris Johns

2025-10-02T22:36:06.067Z

added rtems#10 as parent epic

Author: Chris Johns

2025-12-16T20:45:23.300Z

added rtems#15 as parent epic

Author: Chris Johns

2026-07-31T00:19:05.004Z

Please update the Status.

Merge Requests

262 - shell/memory_commands.rst: Correct mdump example

Id

262

State

merged

Merged by

Joel Sherrill

Merged at

2026-10-08T22:54:12.426Z

Assignee(s)

Joel Sherrill

Created

2026-09-10T15:32:24.693Z

Updated

2026-10-08T22:54:12.418Z

Milestone

6.3

Labels

cpukit::misc

Link

https://gitlab.rtems.org/rtems/docs/rtems-docs/-/merge_requests/262

Commit

0b1af0cdd8045845934e09f691102f06fe3d6708

Summary

shell/memory_commands.rst: Correct mdump example

Replaced output with a run on leon3 using the base text address.

Closes #163

Generative AI

Closes #6

Author: Joel Sherrill

2026-09-10T15:32:24.866Z

assigned to @joel

Author: Joel Sherrill

2026-09-10T20:00:30.528Z

enabled an automatic merge when all merge checks for 64c58ee342a200ff8aa717b614da2273d972a51f pass

Author: Joel Sherrill

2026-09-17T23:27:59.226Z

aborted the automatic merge because target branch was updated

Author: Joel Sherrill

2026-09-18T17:39:52.732Z

added 2 commits

  • 0ccc71f1 - 1 commit from branch rtems/docs:6

  • 0b1af0cd - shell/memory_commands.rst: Correct mdump example

Compare with previous version

Author: Joel Sherrill

2026-09-24T22:05:52.445Z

enabled an automatic merge when all merge checks for 0b1af0cdd8045845934e09f691102f06fe3d6708 pass

Author: Chris Johns

2026-10-08T22:54:09.263Z

approved this merge request

260 - shell/file_and_directory.rst: Correct wrong summary for hexdump

Id

260

State

merged

Merged by

Joel Sherrill

Merged at

2026-09-17T23:27:56.748Z

Assignee(s)

Joel Sherrill

Created

2026-09-09T19:23:47.903Z

Updated

2026-09-17T23:27:56.740Z

Milestone

6.3

Labels

cpukit::shell, doc

Link

https://gitlab.rtems.org/rtems/docs/rtems-docs/-/merge_requests/260

Commit

0ccc71f1d8033ea873e29faa28cfb759ba4f2ab0

Summary

shell/file_and_directory.rst: Correct wrong summary for hexdump

The list of commands at the beginning of the chapter described hexdump as a disk formatter.

Closes #143

Generative AI

Closes #6

Author: Joel Sherrill

2026-09-09T19:23:48.109Z

assigned to @joel

Author: Joel Sherrill

2026-09-09T19:48:31.312Z

added 1 commit

  • 0ccc71f1 - shell/file_and_directory.rst: Correct wrong summary for hexdump

Compare with previous version

Author: Joel Sherrill

2026-09-10T20:00:50.491Z

enabled an automatic merge when all merge checks for 0ccc71f1d8033ea873e29faa28cfb759ba4f2ab0 pass

Author: Chris Johns

2026-09-17T23:27:53.179Z

approved this merge request

258 - build: Fix python warnings

Id

258

State

merged

Merged by

Kinsey Moore

Merged at

2026-08-26T14:24:46.804Z

Assignee(s)

Chris Johns

Created

2026-08-26T02:18:56.924Z

Updated

2026-08-26T14:24:46.725Z

Milestone

6.3

Labels

doc, tool::waf

Link

https://gitlab.rtems.org/rtems/docs/rtems-docs/-/merge_requests/258

Commit

ec0d16dc69dcd2db6ed9cc2c323d7e6b5695a845

Summary

build: Fix python warnings

Closes #160

Generative AI

None

Author: Chris Johns

2026-08-26T02:18:57.117Z

assigned to @chris

Author: Chris Johns

2026-08-26T02:19:50.311Z

enabled an automatic merge when all merge checks for fee9bd15f798bd7f980182d031f9dc78dd87049a pass

Author: Chris Johns

2026-08-26T14:22:16.848Z

aborted the automatic merge because target branch was updated

Author: Kinsey Moore

2026-08-26T14:24:16.702Z

approved this merge request

Author: Kinsey Moore

2026-08-26T14:24:26.836Z

added 3 commits

  • fee9bd15…47bf011e - 2 commits from branch rtems/docs:6

  • ec0d16dc - build: Fix python warnings

Compare with previous version

Author: Kinsey Moore

2026-08-26T14:24:31.931Z

enabled an automatic merge when all merge checks for ec0d16dc69dcd2db6ed9cc2c323d7e6b5695a845 pass

Author: Joel Sherrill

2026-08-26T14:24:45.657Z

approved this merge request

257 - version: Fix building a release with Python 3.14

Id

257

State

merged

Merged by

Kinsey Moore

Merged at

2026-08-26T14:23:35.573Z

Assignee(s)

Chris Johns

Created

2026-08-26T02:14:46.781Z

Updated

2026-08-26T14:23:38.123Z

Milestone

6.3

Labels

doc, tool::waf

Link

https://gitlab.rtems.org/rtems/docs/rtems-docs/-/merge_requests/257

Commit

47bf011eaa2eac3798003e7c023b52ee8b7d5f47

Summary

version: Fix building a release with Python 3.14

Closes #157

Generative AI

None

Author: Chris Johns

2026-08-26T02:14:46.962Z

assigned to @chris

Author: Chris Johns

2026-08-26T02:15:26.211Z

enabled an automatic merge when all merge checks for 4748127ecdc9e66b24f9e1cbae7c4a2a32dc9f2f pass

Author: Chris Johns

2026-08-26T14:22:14.968Z

aborted the automatic merge because target branch was updated

Author: Joel Sherrill

2026-08-26T14:22:51.343Z

approved this merge request

Author: Joel Sherrill

2026-08-26T14:23:00.306Z

added 2 commits

  • 2d65f532 - 1 commit from branch rtems/docs:6

  • 47bf011e - version: Fix building a release with Python 3.14

Compare with previous version

255 - waf: Update to 2.1.9

Id

255

State

merged

Merged by

Chris Johns

Merged at

2026-08-26T14:22:12.995Z

Assignee(s)

Chris Johns

Created

2026-08-25T06:45:07.693Z

Updated

2026-08-26T14:22:12.986Z

Milestone

6.3

Labels

doc, tool::waf

Link

https://gitlab.rtems.org/rtems/docs/rtems-docs/-/merge_requests/255

Commit

2d65f5324eebad79b8a2fb4d90e16723c60efeae

Summary

waf: Update to 2.1.9

Closes #158

Generative AI

None

Author: Chris Johns

2026-08-25T06:45:08.607Z

assigned to @chris

Author: Chris Johns

2026-08-25T06:45:18.918Z

enabled an automatic merge when all merge checks for 2d65f5324eebad79b8a2fb4d90e16723c60efeae pass

Author: Joel Sherrill

2026-08-26T14:22:07.748Z

approved this merge request

253 - user/start/sources: Make release examples consistent

Id

253

State

merged

Merged by

Kinsey Moore

Merged at

2026-08-20T23:17:43.839Z

Assignee(s)

Kinsey Moore

Created

2026-08-18T13:50:13.681Z

Updated

2026-08-20T23:17:43.832Z

Milestone

6.3

Labels

doc::user

Link

https://gitlab.rtems.org/rtems/docs/rtems-docs/-/merge_requests/253

Commit

ef5ddcc15e41435a32e530709135e99e46c92592

Summary

user/start/sources: Make release examples consistent

When version numbers were updated to replaceable references, this section was made confusing due to only part of the example getting updated. This makes the example self-consistent again.

Generative AI

Author: Kinsey Moore

2026-08-18T13:50:13.882Z

assigned to @opticron

Author: Kinsey Moore

2026-08-20T23:00:42.789Z

enabled an automatic merge when all merge checks for ef5ddcc15e41435a32e530709135e99e46c92592 pass

Author: Joel Sherrill

2026-08-20T23:17:41.140Z

approved this merge request

250 - user: Update remaining references to autotools

Id

250

State

merged

Merged by

Joel Sherrill

Merged at

2026-08-13T22:50:23.293Z

Assignee(s)

Kinsey Moore

Created

2026-07-31T16:24:12.591Z

Updated

2026-08-13T22:50:23.285Z

Milestone

6.3

Labels

doc::user

Link

https://gitlab.rtems.org/rtems/docs/rtems-docs/-/merge_requests/250

Commit

cfdf4ec0c64dd7b40dc5851bc3bf028cd6292b2c

Summary

user: Update remaining references to autotools

This swaps the remaining references to autotools for their waf equivalents.

Closes #151

Generative AI

Author: Kinsey Moore

2026-07-31T16:24:12.891Z

assigned to @opticron

Author: Kinsey Moore

2026-07-31T16:24:29.468Z

enabled an automatic merge when all merge checks for 7f128af9a6034e8ea7d30f9df20a6150c6e5b9da pass

Author: Kinsey Moore

2026-07-31T16:24:49.863Z

marked this merge request as blocked by !249

Author: Kinsey Moore

2026-07-31T16:26:27.089Z

mentioned in issue rtems/rtos/rtems#4130

Author: Kinsey Moore

2026-08-13T22:42:54.018Z

added 2 commits

  • 1df6cde3 - user: Update remaining references to autotools

  • cfdf4ec0 - Misc: Update instructions to not reference autoconf build system

Compare with previous version

Author: Joel Sherrill

2026-08-13T22:50:12.580Z

enabled an automatic merge when all merge checks for cfdf4ec0c64dd7b40dc5851bc3bf028cd6292b2c pass

Author: Joel Sherrill

2026-08-13T22:50:21.173Z

approved this merge request