Skip to content

Commit 8d4511b

Browse files
thnkslprptastrogeco
authored andcommitted
Fix #1915, Correct documentation typos
Also fix typos in EDS XML docs
1 parent 5e41330 commit 8d4511b

21 files changed

+91
-91
lines changed

CMakeLists.txt

+3-3
Original file line numberDiff line numberDiff line change
@@ -28,13 +28,13 @@
2828
#
2929
# prepare:
3030
# Use the information in the target config to set up additional variables
31-
# and satisfy any preequisites for targets. Most importantly this stage
32-
# is reposible for finding the actual location of all source files for apps
31+
# and satisfy any prerequisites for targets. Most importantly this stage
32+
# is responsible for finding the actual location of all source files for apps
3333
# listed in the mission configuration, along with collecting any supplemental
3434
# sources, such as EDS files or additional compiler flags.
3535
#
3636
# process_arch:
37-
# This is called multiple times, once for each CPU architecture specfied in
37+
# This is called multiple times, once for each CPU architecture specified in
3838
# the main targets.cmake file. At the mission level, this creates a sub
3939
# project target using the correct toolchain for cross compile. In the arch
4040
# specific level (inside the sub-project) it generates the actual library and

README.md

+8-8
Original file line numberDiff line numberDiff line change
@@ -188,7 +188,7 @@ The detailed cFE user's guide can be viewed at <https://github.com/nasa/cFS/blob
188188

189189
- Uses `int` with %d conversions inUtAssert_True and UtPrintf for platform portability.
190190
- Specifying the special string NULL as the entry point in a startup script results in no entry point being called for the library. Equivalent to leaving the field empty.
191-
- [build system] Adds a hook for an `install_custom.cmake` script that can added to a CPU-specific subdirectory under the "defs" directory. This hook can perform extra installation steps for custom implementations. Tweaks the `add_cfe_tables` function so it can be called from the `install_custom.cmake` script to generate additional table binaries for that CPU.
191+
- [build system] Adds a hook for an `install_custom.cmake` script that can be added to a CPU-specific subdirectory under the "defs" directory. This hook can perform extra installation steps for custom implementations. Tweaks the `add_cfe_tables` function so it can be called from the `install_custom.cmake` script to generate additional table binaries for that CPU.
192192
- [build system] `add_cfe_tables` now uses the "APP_NAME" parameter to associate the table files with the app library, so the same set of include files can be used. Still allows any unique string to be used as "APP_NAME" for backward compatibility. The script will now generate a "Note" message to the user if it does not match an application name.
193193
- If the multiple table feature is used, it actually needs to match the application name, or else the include paths may be incomplete.
194194
- Removes discrepancies (return type, parameter names, etc) between function prototypes and implementation. Also fixes some but not all use of CFE_Status_t in the implementations. Updates ut-stubs accordingly.
@@ -229,7 +229,7 @@ a default handler routine.
229229
Updates the doxygen documentation for this parameter, as it was incorrectly specifying a 32-bit alignment requirement.
230230
- Adds new functional tests for ES Child Task API. Does not check edge cases. Fixed spelling mistake in `UtAssert_ResourceID_Undifeined` name
231231
- Removes BUILDDIR reference and an old comment. No behavior changes
232-
- Moves and renames `cfe_resourceid_basevalue.h` to `cfe_resourceid_basevalue.h`. Since it is is assumed/required that resource IDs follow the "osal compatible" pattern. Perhaps in a future version this could change, but
232+
- Moves and renames `cfe_resourceid_basevalue.h` to `cfe_resourceid_basevalue.h`. Since it is assumed/required that resource IDs follow the "osal compatible" pattern. Perhaps in a future version this could change, but
233233
- Ensures that the `CFE_SUCCESS` constant is of the `CFE_Status_t` type. Since an explicit cast is required on all error codes that are expected to be negative values.
234234
- Removes unused error codes: `CFE_ES_ERR_SHELL_CMD` and `CFE_SB_NO_MSG_RECV`. No impact to behavior.
235235
- When a startup file has a line with too many tokens the build script will generate a concise warning including an indicator of which line is causing the problem.
@@ -330,7 +330,7 @@ Updates the doxygen documentation for this parameter, as it was incorrectly spec
330330

331331
### Development Build: v6.8.0-rc1+dev382
332332

333-
- Refactors the SB buffer descriptor object `CFE_SB_BufferD_t` and simplify the zero-copy buffer paradigm. Combines the zero-copy and the normal CFE buffer descriptor into a single unified `CFE_SB_BufferD_t` object. Results in a simpler zero-copy design that is similarto the the standard, non-zero-copy message path. All message descriptor objects are now tracked in a list by SB. All changes are internal to SB. This does not affect API or behavior of any existing APIs (but see note). Corrects a minor issue where the `MsgSendErrorCounter` would get incremented if there were no subscribers, but only in the zero copy API.
333+
- Refactors the SB buffer descriptor object `CFE_SB_BufferD_t` and simplify the zero-copy buffer paradigm. Combines the zero-copy and the normal CFE buffer descriptor into a single unified `CFE_SB_BufferD_t` object. Results in a simpler zero-copy design that is similar to the standard, non-zero-copy message path. All message descriptor objects are now tracked in a list by SB. All changes are internal to SB. This does not affect API or behavior of any existing APIs (but see note). Corrects a minor issue where the `MsgSendErrorCounter` would get incremented if there were no subscribers, but only in the zero copy API.
334334
- Replaces `int_32` with `CFE_Status_t` for all error message codes
335335
- Removes references to `cfeesugshellsrv` from user guide
336336
- Adds null pointer checks and size checks to validate method parameters. Returning the input instead of an error code
@@ -359,7 +359,7 @@ Updates the doxygen documentation for this parameter, as it was incorrectly spec
359359

360360
### Development Build: v6.8.0-rc1+dev348
361361

362-
- Corrects reference to PSP header file location. Build now succesfully completes the build succeeds again when using `add_psp_module()` in custom CMakeLists file.
362+
- Corrects reference to PSP header file location. Build now successfully completes the build succeeds again when using `add_psp_module()` in custom CMakeLists file.
363363
- Replace "send" with "write" in names for commands that write files. For example, `CFE_SB_**SEND**_ROUTING_INFO_CC` is now `CFE_SB_**WRITE**_ROUTING_INFO_CC`. Updates function names, command code names and comments.
364364
- Removes incorrectly implemented deferred return code of `-1` for `CFE_SB_ReceiveBuffer` from software bus setup in `UT_InitData`.
365365
- Implements more informative **assert messages** by making `SETUP, TEARDOWN, ASSERT` print `0x%lx` while `ASSERT_EQ` now prints both `%lf` and `0x%lx` format for the inputs
@@ -380,7 +380,7 @@ Updates the doxygen documentation for this parameter, as it was incorrectly spec
380380
- Removes the remnants of the table service exclusion logic and documentation: `EXCLUDE_CFE_TBL` no longer available, even if defined, table services will still start.
381381
- Set ES and EVS pipe message limit to defaults as opposed to the custom, unjustified, `CFE_SB_SubscribeEx`. This change might queue additional HK messages, but SCH loads after ES anyways.
382382
- Replaces `CFE_SB_Default_Qos` with `CFE_SB_DEFAULT_QOS` macro that avoids global variable exposure. Removes SB-internal defines that are not implemented nor used.
383-
- Explicity `memset` the task data to zero at the start of EarlyInit. Standardize the global typdef/variable names.
383+
- Explicitly `memset` the task data to zero at the start of EarlyInit. Standardize the global typedef/variable names.
384384
- Moves all functions, macros, types, and other definitions related to resource IDs and generic resource management into a separate module, like `CFE MSG`, `SBR`, etc. This allows a mission to elect "strict" implementations of these objects, where every ID type is unique, and assigning between them or `uint32` results in a compiler error. **API now has separate types for each resource type (Apps, Tasks, Libs, Counters, etc).** The user can elect at the mission level whether this is a simple typedef (all uint32, all interchangeable) or a wrapper type (separate/strict type, cannot be interchanged). The former is backward compatible but the latter is not - must use proper types.
385385
- Adds Code QL analysis to continuous integration workflow.
386386
- See <https://github.com/nasa/cFE/pull/1150>
@@ -400,7 +400,7 @@ Updates the doxygen documentation for this parameter, as it was incorrectly spec
400400
- For primary-only header config: telemetry header required to 64 bit boundary (affects all receivers)
401401
- For primary and extended header config: command header required padding to 64 bit boundary (affects all senders)
402402
- Refactor `CFE_TIME_RegisterSynchCallback` to only have one return point and eliminates "possible uninitialized variable" static analysis warning
403-
- None of these changes are expected to cause problematic.
403+
- None of these changes are expected to be problematic.
404404
- Addresses message delivery issues due to inconsistent locking by reworking cFE-SB API implementation. Ensures all events are generated and counters are incremented consistently by avoiding early returns in functions and using the `PendingEventID` register to record what event ID should be sent per the current operation.
405405
- Employs the `CFE_ES_ResourceID_t` type and related patterns for managing the SB Pipe IDs.
406406
- Will break code which directly accessed these items without going through the lookup function.
@@ -439,7 +439,7 @@ Updates the doxygen documentation for this parameter, as it was incorrectly spec
439439

440440
- Remove use of `osapi-os-loader.h` from ES UT.
441441
- Use volatile `sig_atomic_t` for system state to avoid race issue if uint32 isn't atomic on a system
442-
- Set the flags parameter on the OS_ModuleLoad() properly to allow an app to be properly unloaded, which in turn allows the reload command to work as expected. Fixes problem where unload comand resulted in continuous restarting of the same app code.
442+
- Set the flags parameter on the OS_ModuleLoad() properly to allow an app to be properly unloaded, which in turn allows the reload command to work as expected. Fixes problem where unload command resulted in continuous restarting of the same app code.
443443
- Replaced `Test_MSG_PrintMsg` with `UT_DisplayPkt`. Also removed unused `Test_MSG_Sum`.
444444
- See <https://github.com/nasa/cFE/pull/1047>
445445

@@ -593,7 +593,7 @@ of the OSAL limit. Task name shows up as `ES_BG_TASK`
593593
### Development Build: v6.8.0-rc1+dev13
594594

595595
- Deprecates `CFE_SB_GetLastSenderId()` API by introducing new `CFE_OMIT_DEPRECATED_6_8` tag
596-
- Documentation update remove deleted requiremements
596+
- Documentation update remove deleted requirements
597597
- Add a new *cfe_assert* module for functional testing by making it possible to load the UT assert object code as a CFE library. These are compiled as separate, independent modules and only loaded on demand. Also includes a draft example for cFE testing, which calls some basic ES AppId functions.
598598
- See <https://github.com/nasa/cFE/pull/816>
599599

SECURITY.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ To report a vulnerability for the cFE subsystem please [submit an issue](https:/
66

77
For general cFS vulnerabilities please [open a cFS framework issue](https://github.com/nasa/cfs/issues/new/choose) and see our [top-level security policy](https://github.com/nasa/cFS/security/policy) for additional information.
88

9-
In either case please use the "Bug Report" template and provide as much information as possible. Apply appropraite labels for each report. For security related reports, tag the issue with the "security" label.
9+
In either case please use the "Bug Report" template and provide as much information as possible. Apply appropriate labels for each report. For security related reports, tag the issue with the "security" label.
1010

1111
## Testing
1212

cmake/target/CMakeLists.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -245,7 +245,7 @@ if (DEFINED ${TGTNAME}_EMBED_FILELIST)
245245

246246
endforeach(LISTENT ${${TGTNAME}_EMBED_FILELIST})
247247

248-
# Finally, generate a static library that contains all embeded binary files
248+
# Finally, generate a static library that contains all embedded binary files
249249
# and add this to the list of libraries that the CFE will be linked with.
250250
# add a dependency so that the "inc" files are regenerated and the library
251251
# is rebuilt before the static library is built.

docs/README_static_app_linkage.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -89,7 +89,7 @@ This allows symbol lookups to succeed even on systems that do not have any
8989
dynamic lookup capabilities.
9090

9191
Each entry should be a comma-separated pair indicating a symbol name and the
92-
module name that would define it in a dynamically-linked environement.
92+
module name that would define it in a dynamically-linked environment.
9393

9494
**NOTE**: To be more portable this operates on the abstract module name as
9595
opposed to the file name. This corresponds to the 4th parameter on each line

docs/cFE Application Developers Guide.md

+8-8
Original file line numberDiff line numberDiff line change
@@ -324,7 +324,7 @@ complete cFE core executive. These modules are all contained under the `modules
324324
| `modules/evs/` | Implementation of the Event Services (EVS) core module - manages sending of events on behalf of other apps |
325325
| `modules/fs/` | Implementation of the File Services (FS) core module - defines file-related functions |
326326
| `modules/msg/` | Implementation of the Message (MSG) core module - defines message header manipulation/access routines |
327-
| `modules/resourceid/` | Implementation of the Resource ID core module - maniplation/access of system resource IDs (AppID, PipeID, etc.) |
327+
| `modules/resourceid/` | Implementation of the Resource ID core module - manipulation/access of system resource IDs (AppID, PipeID, etc.) |
328328
| `modules/sb/` | Implementation of the Software Bus (SB) core module - sends messages between applications |
329329
| `modules/tbl/` | Implementation of the Table Services (TBL) core module - manages runtime tables |
330330
| `modules/time/` | Implementation of the Time Services (TIME) core module - manages timing and synchronization |
@@ -488,7 +488,7 @@ deciding on whether to create multiple Applications versus a single
488488
Application with multiple Tasks, the Application Developer should keep
489489
in mind these facts:
490490

491-
- When the Application exits it is the responsiabilty of the
491+
- When the Application exits it is the responsibility of the
492492
Main Task to safely stop all of its Child Tasks.
493493

494494
- If the Main Task of an Application is stopped, either through
@@ -897,7 +897,7 @@ to the OSAL Library API).
897897
## 5.8 Interrupt Handling
898898

899899
OSAL interrupt handling functions have been deprecated due to
900-
platform dependencies, incomplete testing, and incomplete implementaion
900+
platform dependencies, incomplete testing, and incomplete implementation
901901

902902
No longer supporting abstracted interrupt handling API from OSAL. Could
903903
consider at the PSP layer as future work but current dependencies should
@@ -979,7 +979,7 @@ equal to the requested block size.
979979
The specific size of the management structure depends on the platform
980980
architecture word size and alignment requirements, and padding may be
981981
added as necessary to meet the system requirements. For illustrative
982-
purposes, the examples below use sizes that are respresentative of a
982+
purposes, the examples below use sizes that are representative of a
983983
32-bit CPU with 32-bit buffer alignment with no extra alignment padding
984984
added. The pool overhead will increase on a 64-bit CPU with 64-bit
985985
alignment, or if pool alignment configured greater than 32 bits. For
@@ -1035,8 +1035,8 @@ Figure 5.2 Example mempool allocations
10351035
### 5.10.2 Memory Read/Write Functions
10361036

10371037
CFE provides a set of functions that read and write values of fixed sizes at
1038-
specified physical addresses. These functions are intended for accessing h
1039-
ardware registers or memory devices with nonstandard properties. The EEPROM
1038+
specified physical addresses. These functions are intended for accessing
1039+
hardware registers or memory devices with nonstandard properties. The EEPROM
10401040
functions perform whatever operations are required for enabling the modification
10411041
of EEPROM and then verify that the modification was successful.
10421042

@@ -1406,9 +1406,9 @@ structure can be changed without affecting cFS Applications.
14061406

14071407
See the implementation documentation for specific formats,
14081408
fields, and bit values. The message ID (MsgId) is an abstract
1409-
concept that is implementation depended, used for routing messages
1409+
concept that is implementation dependent, used for routing messages
14101410
on the Software Bus. Depending on the implementation, different
1411-
ranges and values are supported, and the values effect the message
1411+
ranges and values are supported, and the values affect the message
14121412
header differently.
14131413

14141414
If you are using the default, MsgID maps directly to the CCSDS Stream ID.

docs/src/cfe_es.dox

+4-4
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
through the Platform Support Package (PSP).
1515

1616
The functionality provided by the ES task include Software Reset,
17-
Application and Child Task Mangement, Basic File System, Performance Data
17+
Application and Child Task Management, Basic File System, Performance Data
1818
Collection, Critical Data Store, Memory Pool, System Log, Shell Command.
1919

2020
For additional detail on Executive Services, see the following sections:
@@ -385,7 +385,7 @@
385385
The #CFE_ES_RELOAD_APP_CC command is used to reload an application
386386
using a new file name.
387387

388-
This command performes
388+
This command performs
389389
the same actions as #CFE_ES_RESTART_APP_CC only using the new file.
390390

391391
Next: \ref cfeesugapplist <BR>
@@ -420,7 +420,7 @@
420420
<LI> <B>Load Address</B> - The starting address of memory where the Application was loaded <BR>
421421
<LI> <B>Load Size</B> - The size, in bytes, of the Application when loaded into memory <BR>
422422
<LI> <B>Start Address</B> - The physical address that maps to the Entry Point <BR>
423-
<LI> <B>Exception Action</B> - A flag that identifies whether the the Processor should undergo
423+
<LI> <B>Exception Action</B> - A flag that identifies whether the Processor should undergo
424424
a Restart or whether just the Application should restart upon an exception condition
425425
within the Application <BR>
426426
<LI> <B>Priority</B> - The assigned priority for the Application <BR>
@@ -754,7 +754,7 @@
754754
<UL>
755755
<LI> <B>Memory Pool Handle</B> - the handle, as provided by the operator in the
756756
\link #CFE_ES_SEND_MEM_POOL_STATS_CC Telemeter Memory Pool Statistics Command. \endlink
757-
This repeating of the handle in telemetry insures the operator knows which Memory
757+
This repeating of the handle in telemetry ensures the operator knows which Memory
758758
Pool Statistics are being viewed <BR>
759759
<LI> <B>Pool Size</B> - The total size of the memory pool (in bytes)<BR>
760760
<LI> <B>Number Blocks Requested</B> - The total number of memory blocks requested for allocation<BR>

0 commit comments

Comments
 (0)