-
Notifications
You must be signed in to change notification settings - Fork 430
Add missing :throws:
doc tags in package modules
#27440
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Conversation
Signed-off-by: Anna Rift <anna.rift@hpe.com>
Signed-off-by: Anna Rift <anna.rift@hpe.com>
Signed-off-by: Anna Rift <anna.rift@hpe.com>
Signed-off-by: Anna Rift <anna.rift@hpe.com>
As well as making a :throws: on FileSystem.exists more specific Signed-off-by: Anna Rift <anna.rift@hpe.com>
Signed-off-by: Anna Rift <anna.rift@hpe.com>
Signed-off-by: Anna Rift <anna.rift@hpe.com>
Signed-off-by: Anna Rift <anna.rift@hpe.com>
Signed-off-by: Anna Rift <anna.rift@hpe.com>
1a1e47f
to
22efac7
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Awesome work. Thanks for taking the time to read through all the code and ascertain what was being thrown where.
@@ -831,7 +835,12 @@ used to recursively hold tables and respective values | |||
} | |||
|
|||
|
|||
/* Write a Table to channel f in TOML format */ | |||
/* | |||
Write a Table to channel f in TOML format |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
nit: period to match the style of the above comment
@@ -1121,7 +1132,11 @@ module TomlReader { | |||
|
|||
config const debugTomlReader = false; | |||
|
|||
/* Returns the next token in the current line without removing it */ | |||
/* | |||
Returns the next token in the current line without removing it |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
nit: period to match the style of the first added comment
@@ -1274,7 +1289,11 @@ module TomlReader { | |||
} | |||
|
|||
|
|||
/* retrieves next token in currentLine */ | |||
/* | |||
Retrieves next token in currentLine |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
nit: period to match the style of the first added comment
Add missing
:throws:
docs tags to procedures in these package modules:Buffers
Crypto
Curl
HDF5
HDFS
LinearAlgebra
RecordParser
TOML
Used the list from #11417 plus just grepping for
throws
, and excluded no-doc procs.ZMQ
was on the list but not modified as it wasn't missing any tags.Contributes to #11417.
[reviewer info placeholder]
Testing: