Skip to content

docs: fix typos in comments, docstrings and log messages - #8

Open
Léon Simmons (Avicennasis) wants to merge 1 commit into
qualcomm:mainfrom
Avicennasis:docs/fix-typos
Open

Léon Simmons (Avicennasis) wants to merge 1 commit into
qualcomm:mainfrom
Avicennasis:docs/fix-typos

Conversation

@Avicennasis

Copy link
Copy Markdown

Summary

Fixes 19 verified typos / documentation inaccuracies across 4 files. All changes are in comments, docstrings and log-message strings. No identifiers were renamed and no program logic was changed.

  • dtlogger.py: replaced CJK punctuation in the English logger_init docstring ( -> . x5, -> , ); Maxmin log file size -> Maximum log file size
  • sign.py: signature. it will -> signature. It will; popout -> pop out; a warning windows -> a warning window; termined signing process -> terminate the signing process; origninal -> original; orginal -> original (x2); commnad excute done -> command execute done (x2, log strings); # excute sign command seperately -> # execute sign command separately; 'Excute Signing Command: -> 'Execute Signing Command:
  • XBLConfig/commons.py: aligment -> alignment
  • get_qsahara_files.py: the get_all_sahara_files docstring documented an argument named contents_xml_path, which is not a parameter of the function; renamed to the real parameter meta_root_path and corrected the description accordingly

Please review carefully

Four of these changes are inside runtime log strings rather than comments, so they change emitted log text (not behaviour):
dtlogger.info('Waiting for secure inspect commnad excute done'), dtlogger.info('secure inspect commnad excute done') and dtlogger.info('Excute Signing Command:...') in sign.py. There are no tests in the repository asserting on these strings.

The same misspellings also occur in assemble.py, xblcfgint.py and XBLConfig/elf_gen_gui.py; those were left alone to keep this change scoped, and are happy to include them if you would prefer a single sweep.

Commit is DCO signed off as required by CONTRIBUTING.md.

Corrects misspellings and doc inaccuracies in comments, docstrings and
log strings. No functional changes to program logic.

Signed-off-by: Léon Avic Simmons <Avicennasis@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant