From 987ecd2a6cad82c7cb44ee9065d708f778af35fb Mon Sep 17 00:00:00 2001 From: vapniks Date: Sun, 11 May 2025 00:09:05 +0100 Subject: [PATCH 01/19] Fix grammar in write.rst --- doc/readthedocs/debugger/commands/data/write.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/readthedocs/debugger/commands/data/write.rst b/doc/readthedocs/debugger/commands/data/write.rst index 49c34689f..e0bce234a 100644 --- a/doc/readthedocs/debugger/commands/data/write.rst +++ b/doc/readthedocs/debugger/commands/data/write.rst @@ -8,9 +8,9 @@ Write the Commands of a Target (`write`) Use this to write the command portion of a target with `remake`s internal variables expanded. If a filename is given that is the file -where the expanded commands are written. If the filename is `here` -then it is not written to a file but output inside the debugger as -other debugger commands behave. And if no file name is given a +where the expanded commands are written. If the filename is "here" +then it is not written to a file but output inside the debugger like how +other debugger commands behave. If no file name is given a filename based on the target name is created. From 0978464d50a16f526a60be15df68c9ab761cf098 Mon Sep 17 00:00:00 2001 From: vapniks Date: Sun, 11 May 2025 00:11:33 +0100 Subject: [PATCH 02/19] Fix grammar in edit.rst --- doc/readthedocs/debugger/commands/files/edit.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/readthedocs/debugger/commands/files/edit.rst b/doc/readthedocs/debugger/commands/files/edit.rst index c946ef2ce..7ce27fc06 100644 --- a/doc/readthedocs/debugger/commands/files/edit.rst +++ b/doc/readthedocs/debugger/commands/files/edit.rst @@ -6,12 +6,12 @@ Edit Makefile (`edit`) **edit** -Edit Make at the current target location. +Edit the Makefile at the current target location. The editing program of your choice is invoked with the current line set to the active line in the program. -You can customize to use any editor you want by using the `EDITOR` +You can customize it to use any editor you want by using the `EDITOR` environment variable. The only restriction is that your editor, .e.g. `ex`, recognizes the following command-line syntax: @@ -22,7 +22,7 @@ environment variable. The only restriction is that your editor, .e.g. The optional numeric value *+number* specifies the number of the line in the file where to start editing. For example, to configure `remake` to use the `emacs` editor, you could use these commands -with the in a POSIX shell: +in a POSIX shell: :: From c5376a1ce66509907d2db3886c55e1ed1cb57e39 Mon Sep 17 00:00:00 2001 From: vapniks Date: Sun, 11 May 2025 00:13:16 +0100 Subject: [PATCH 03/19] Fix grammar in list.rst --- doc/readthedocs/debugger/commands/files/list.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/readthedocs/debugger/commands/files/list.rst b/doc/readthedocs/debugger/commands/files/list.rst index 5fc563b23..c797fc8e5 100644 --- a/doc/readthedocs/debugger/commands/files/list.rst +++ b/doc/readthedocs/debugger/commands/files/list.rst @@ -8,7 +8,7 @@ List Makefile target (`list`) **list** *line-number* | **-** -List target dependencies and commands for *target* or *line-number* +List the dependencies and commands for a *target* or *line-number* Without a target name or line number, use the current target. A target name of `-` will use the parent target on the target stack. From 20db10d4f2fe1b036032bc3f74eba16dd4b1f80d Mon Sep 17 00:00:00 2001 From: vapniks Date: Sun, 11 May 2025 00:15:05 +0100 Subject: [PATCH 04/19] Fix grammar in load.rst --- doc/readthedocs/debugger/commands/files/load.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/doc/readthedocs/debugger/commands/files/load.rst b/doc/readthedocs/debugger/commands/files/load.rst index c854af92d..e27251818 100644 --- a/doc/readthedocs/debugger/commands/files/load.rst +++ b/doc/readthedocs/debugger/commands/files/load.rst @@ -8,15 +8,15 @@ Read and Evaluate Makefile (`load`) Read in and evaluate GNU Makefile *file-glob*.. -*file-glob* should resolve after glob expansion to single GNU +*file-glob* should resolve after glob expansion to a single GNU Makefile. Target dependencies are updated after reading in the file. Here are several possible uses of this command. -In debug sessions you can fix the source code and the run `load` to have the code reread in, to test out the fix. +In debug sessions you can fix the source code and then run `load` to have the code reread in, to test out the fix. -Another use is to have pecific "debug"-oriented Makefiles that aren't -normally used, but when you want to trace things are avialable. +Another use is to have specific "debug"-oriented Makefiles that aren't +normally used, but are available when you want to trace things. This is an aspect of aspect-oriented_ programming .. _aspect-oriented: https://en.wikipedia.org/wiki/Aspect-oriented_programming From 46834508be9e683bb7cbdd99a8ac14c7a3c431a7 Mon Sep 17 00:00:00 2001 From: vapniks Date: Sun, 11 May 2025 00:16:52 +0100 Subject: [PATCH 05/19] Fix grammar in info.rst --- doc/readthedocs/debugger/commands/info.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/readthedocs/debugger/commands/info.rst b/doc/readthedocs/debugger/commands/info.rst index c1d18a4a5..8a21cfa31 100644 --- a/doc/readthedocs/debugger/commands/info.rst +++ b/doc/readthedocs/debugger/commands/info.rst @@ -8,7 +8,7 @@ Information from the Debugged Session (`break`, `files`, `line`, `program`, `rul Gets various pieces of information about the program being debugged. -You can give unique prefix of the name of a subcommand to get +You can give a unique prefix of the name of a subcommand to get information about just that subcommand. Type `info` for a list of info subcommands and what they do. Type ``help info`` for a summary list of info subcommands. From 9f396203961544e884ca026c7f8506b95d19b1e7 Mon Sep 17 00:00:00 2001 From: vapniks Date: Sun, 11 May 2025 00:30:35 +0100 Subject: [PATCH 06/19] Update break.rst with mask info --- doc/readthedocs/debugger/commands/info/break.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/readthedocs/debugger/commands/info/break.rst b/doc/readthedocs/debugger/commands/info/break.rst index b7d073e68..205cd241f 100644 --- a/doc/readthedocs/debugger/commands/info/break.rst +++ b/doc/readthedocs/debugger/commands/info/break.rst @@ -8,11 +8,11 @@ List all Breakpoints (`info break`) Show status of user-settable breakpoints. -The columns in a line show are as follows: +The columns in the output lines are as follows: * The \"Num\" column is the breakpoint number which can be used in a `delete` command. -* The \"Disp\" column contains one of \"keep\", \"del\", the disposition of the breakpoint after it gets hit. -* The \"mask\" at which points within the target that we stop +* The \"Disp\" column contains one of \"keep\", \"del\"; the disposition of the breakpoint after it gets hit. +* The \"mask\" column indicates at which points of the breakpoint execution is stopped (0x01=prereq, 0x02=run, 0x04=end, 0x07=all). * The \"Where\" column indicates where the breakpoint is located. Example: From 4790d2287739320dac1321fbf531fb1c387f5316 Mon Sep 17 00:00:00 2001 From: vapniks Date: Sun, 11 May 2025 00:34:30 +0100 Subject: [PATCH 07/19] Fix grammar in cd.rst --- doc/readthedocs/debugger/commands/os/cd.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/readthedocs/debugger/commands/os/cd.rst b/doc/readthedocs/debugger/commands/os/cd.rst index 9a3c1cfa1..7564e3dc6 100644 --- a/doc/readthedocs/debugger/commands/os/cd.rst +++ b/doc/readthedocs/debugger/commands/os/cd.rst @@ -8,7 +8,7 @@ Set the Current Working Directory (`cd`) Set the working directory to *dir*. -Changing this changes will the working directory in any subsequent +Changing this changes the working directory for any subsequent build commands that are invoked. .. seealso:: From 2441c70db1cadae1789f91443bd147233ed1bce3 Mon Sep 17 00:00:00 2001 From: vapniks Date: Sun, 11 May 2025 00:35:35 +0100 Subject: [PATCH 08/19] Fix grammar in pwd.rst --- doc/readthedocs/debugger/commands/os/pwd.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/readthedocs/debugger/commands/os/pwd.rst b/doc/readthedocs/debugger/commands/os/pwd.rst index 0e7d8b580..2b4b21200 100644 --- a/doc/readthedocs/debugger/commands/os/pwd.rst +++ b/doc/readthedocs/debugger/commands/os/pwd.rst @@ -6,9 +6,9 @@ Print POSIX Working Directory (`pwd`) **pwd** -Print working directory. +Print the working directory. -By default, this is the working directory for in any commands that run from the build. +By default, this is the working directory for any commands that run from the build. .. seealso:: From a4555a1e6516cf7a629154493cc4365c7e3e39ed Mon Sep 17 00:00:00 2001 From: vapniks Date: Sun, 11 May 2025 00:36:57 +0100 Subject: [PATCH 09/19] Fix grammar in running.rst --- doc/readthedocs/debugger/commands/running.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/readthedocs/debugger/commands/running.rst b/doc/readthedocs/debugger/commands/running.rst index 6a8fa207f..b0f4c98b4 100644 --- a/doc/readthedocs/debugger/commands/running.rst +++ b/doc/readthedocs/debugger/commands/running.rst @@ -13,7 +13,7 @@ program execution. You can: * restart the program * continue its execution until it would normally terminate or until a breakpoint is hit -* step exection which is runs for a limited amount of code before stopping +* step exection which runs for a limited amount of code before stopping .. toctree:: :maxdepth: 1 From 5db96cbee57342d86748ad780bac3eb7cf0636c4 Mon Sep 17 00:00:00 2001 From: vapniks Date: Sun, 11 May 2025 00:39:51 +0100 Subject: [PATCH 10/19] Fix grammar in continue.rst --- doc/readthedocs/debugger/commands/running/continue.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/readthedocs/debugger/commands/running/continue.rst b/doc/readthedocs/debugger/commands/running/continue.rst index 1eaf283b1..ae66c93b4 100644 --- a/doc/readthedocs/debugger/commands/running/continue.rst +++ b/doc/readthedocs/debugger/commands/running/continue.rst @@ -10,7 +10,7 @@ Continue executing debugged Makefile until another breakpoint or stopping point. If a target is given and valid we set a breakpoint at that target before continuing. -As with the `break` command, the place in a target is in can be +As with the `break` command, the precise stopping place within a target line can be specified. See :ref:`break ` for a list of the meanings of the target phases. From bfdb31474caf58d0b0d449f6525f2e566c11428b Mon Sep 17 00:00:00 2001 From: vapniks Date: Sun, 11 May 2025 00:42:51 +0100 Subject: [PATCH 11/19] Fix grammar in next.rst --- doc/readthedocs/debugger/commands/running/next.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/readthedocs/debugger/commands/running/next.rst b/doc/readthedocs/debugger/commands/running/next.rst index f3c102775..9c64925cd 100644 --- a/doc/readthedocs/debugger/commands/running/next.rst +++ b/doc/readthedocs/debugger/commands/running/next.rst @@ -15,7 +15,7 @@ Argument *count* means do this *count* times or until there's another reason to If you want more fine-grained stepping use :ref:`skip `. - If you want to not stop at any of targets the current target depends - on, but instead run until after this target is remade, :ref:`finish `. + If you want to not stop at any dependencies of the current target, + but instead run until after this target is remade use :ref:`finish `. - :ref:`skip `, and :ref:`continue `, provide other ways to progress execution. + :ref:`skip `, and :ref:`continue `, provide other ways to continue execution. From 5ad2fe7424e93b4e3f1b95c68982f71a360b9c3e Mon Sep 17 00:00:00 2001 From: vapniks Date: Sun, 11 May 2025 00:44:15 +0100 Subject: [PATCH 12/19] fix typo in step.rst --- doc/readthedocs/debugger/commands/running/step.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/readthedocs/debugger/commands/running/step.rst b/doc/readthedocs/debugger/commands/running/step.rst index e763749bf..4122d8bba 100644 --- a/doc/readthedocs/debugger/commands/running/step.rst +++ b/doc/readthedocs/debugger/commands/running/step.rst @@ -12,7 +12,7 @@ Stepping is like `next` but it is more fine-grained. However we still don't stop at targets for which there is no rule. Argument *count* means do this *count* times (or until there's another -reason to stop. +reason to stop). Examples: +++++++++ From 3d5d31ed26ae1111f531dd1ee4476dd188876c63 Mon Sep 17 00:00:00 2001 From: vapniks Date: Sun, 11 May 2025 00:45:24 +0100 Subject: [PATCH 13/19] Fix grammar in set.rst --- doc/readthedocs/debugger/commands/set.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/readthedocs/debugger/commands/set.rst b/doc/readthedocs/debugger/commands/set.rst index fbbfee684..9a1d031d8 100644 --- a/doc/readthedocs/debugger/commands/set.rst +++ b/doc/readthedocs/debugger/commands/set.rst @@ -5,7 +5,7 @@ Modifies parts of the debugger environment. -You can give unique prefix of the name of a subcommand to get information about just that subcommand. +You can give a unique prefix of the name of a subcommand to get information about just that subcommand. Type `set` for a list of set subcommands and what they do. Type ``help set`` for a summary list of set subcommands. From bbeeb94b85634c7cef3097037e241af9f5ebaea7 Mon Sep 17 00:00:00 2001 From: vapniks Date: Sun, 11 May 2025 00:47:46 +0100 Subject: [PATCH 14/19] Fix typos in show.rst --- doc/readthedocs/debugger/commands/show.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/readthedocs/debugger/commands/show.rst b/doc/readthedocs/debugger/commands/show.rst index 1e2a10914..833439313 100644 --- a/doc/readthedocs/debugger/commands/show.rst +++ b/doc/readthedocs/debugger/commands/show.rst @@ -4,8 +4,8 @@ **show** [ *subcommand* ] -A command for showing things about the debugger. You can give unique prefix of the name of a subcommand to get information about just that subcommand. -nn +A command for showing things about the debugger. You can give a unique prefix of the name of a subcommand to get information about just that subcommand. + Type `show` for a list of show subcommands and what they do. Type ``help show`` for a summmary list of show subcommands. Many of the "show" commands have a corresponding :ref:`set ` command. From 9a54d864d36342a1163c5157688f2b90c82f71dd Mon Sep 17 00:00:00 2001 From: vapniks Date: Sun, 11 May 2025 00:49:14 +0100 Subject: [PATCH 15/19] Fix typo in keep-going.rst --- doc/readthedocs/debugger/commands/show/keep-going.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/readthedocs/debugger/commands/show/keep-going.rst b/doc/readthedocs/debugger/commands/show/keep-going.rst index 8ddb21e37..c2737f8f9 100644 --- a/doc/readthedocs/debugger/commands/show/keep-going.rst +++ b/doc/readthedocs/debugger/commands/show/keep-going.rst @@ -6,7 +6,7 @@ Show the value of the GNU Make `-k` flag (`show keep-going`) **show keep-going** -Set value of GNU Make `--keep-going` (or `-k`) flag. +Show the value of the GNU Make `--keep-going` (or `-k`) flag. .. seealso:: From 3b00d6d3ed6ecd620d20429326dfd54b5b7ba9ab Mon Sep 17 00:00:00 2001 From: vapniks Date: Sun, 11 May 2025 00:54:02 +0100 Subject: [PATCH 16/19] Fix grammar in down.rst --- doc/readthedocs/debugger/commands/stack/down.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/readthedocs/debugger/commands/stack/down.rst b/doc/readthedocs/debugger/commands/stack/down.rst index 48028d862..1881f1230 100644 --- a/doc/readthedocs/debugger/commands/stack/down.rst +++ b/doc/readthedocs/debugger/commands/stack/down.rst @@ -6,13 +6,13 @@ Relative Motion towards a More-Recent Target (`down`) **down** [ *count* ] -Select and print the target this one caused to be examined. +Select and print the target that the current target caused to be examined (and is dependent on). If *count* is given then select that many targets down; the default is 1. When you enter the debugger this command doesn't make a lot of sense because you are at the most-recently frame. However if you issue -`down` and `frame` commands, this can change. +`up` and `frame` commands, this can change. .. seealso:: From 57cdb2d7866fb6afd33b7ce51845d0b7f79942a3 Mon Sep 17 00:00:00 2001 From: vapniks Date: Sun, 11 May 2025 00:55:11 +0100 Subject: [PATCH 17/19] Fix grammar in help.rst --- doc/readthedocs/debugger/commands/support/help.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/readthedocs/debugger/commands/support/help.rst b/doc/readthedocs/debugger/commands/support/help.rst index 8fb445b9c..68c3d708c 100644 --- a/doc/readthedocs/debugger/commands/support/help.rst +++ b/doc/readthedocs/debugger/commands/support/help.rst @@ -10,10 +10,10 @@ Get help for a debugger command or subcommand. Without an argument, print the list of available debugger commands. -When an argument is given, it is first checked to see if it is command +When an argument is given, it is first checked to see if it is a command name. Some commands like `info`, `set`, and `show` can accept an -additional subcommand to give help just about that particular -subcommand. For example `help set basename` give help about the +additional subcommand to give help about just that particular +subcommand. For example `help set basename` gives help about the `basename` subcommand of `set`. From 078e2dec7c4c2825e915d6c5927feb54d2980778 Mon Sep 17 00:00:00 2001 From: vapniks Date: Sun, 11 May 2025 00:56:16 +0100 Subject: [PATCH 18/19] Fix grammar in source.rst --- doc/readthedocs/debugger/commands/support/source.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/readthedocs/debugger/commands/support/source.rst b/doc/readthedocs/debugger/commands/support/source.rst index 2d914f963..2268bc2b9 100644 --- a/doc/readthedocs/debugger/commands/support/source.rst +++ b/doc/readthedocs/debugger/commands/support/source.rst @@ -8,7 +8,7 @@ Read and Run Debugger Commands from a File (`source`) Read debugger commands from the glob expansion of *file-glob*; -*file-glob* should resolve after glob expansion to single file. +*file-glob* should resolve to a single file after glob expansion. Examples: +++++++++ From 8cb0a8403ebfcec29ff6664d2855e3aeee5b90fc Mon Sep 17 00:00:00 2001 From: "R. Bernstein" Date: Sun, 11 May 2025 11:40:14 -0400 Subject: [PATCH 19/19] Update doc/readthedocs/debugger/commands/data/write.rst --- doc/readthedocs/debugger/commands/data/write.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/readthedocs/debugger/commands/data/write.rst b/doc/readthedocs/debugger/commands/data/write.rst index e0bce234a..c0a4bfa1e 100644 --- a/doc/readthedocs/debugger/commands/data/write.rst +++ b/doc/readthedocs/debugger/commands/data/write.rst @@ -10,7 +10,7 @@ Use this to write the command portion of a target with `remake`s internal variables expanded. If a filename is given that is the file where the expanded commands are written. If the filename is "here" then it is not written to a file but output inside the debugger like how -other debugger commands behave. If no file name is given a +other debugger commands behave. If no file name is given, a filename based on the target name is created.