Minor documentation improvements
This commit is contained in:
parent
f296cdb2ab
commit
974232f045
1 changed files with 6 additions and 3 deletions
|
@ -88,8 +88,9 @@ class ChangeLog:
|
||||||
def __init__(self, input_stream):
|
def __init__(self, input_stream):
|
||||||
"""Create a changelog object.
|
"""Create a changelog object.
|
||||||
|
|
||||||
Read lines from input_stream, which is typically a file opened
|
Populate the changelog object from the content of the file
|
||||||
for reading.
|
input_stream. This is typically a file opened for reading, but
|
||||||
|
can be any generator returning the lines to read.
|
||||||
"""
|
"""
|
||||||
level_2_seen = 0
|
level_2_seen = 0
|
||||||
current_section = None
|
current_section = None
|
||||||
|
@ -125,7 +126,9 @@ class ChangeLog:
|
||||||
Markdown sections with recognized titles. The corresponding
|
Markdown sections with recognized titles. The corresponding
|
||||||
content is injected into the respective sections in the changelog.
|
content is injected into the respective sections in the changelog.
|
||||||
The section titles must be either one of the hard-coded values
|
The section titles must be either one of the hard-coded values
|
||||||
in assemble_changelog.py or already present in ChangeLog.md.
|
in STANDARD_SECTIONS in assemble_changelog.py or already present
|
||||||
|
in ChangeLog.md. Section titles must match byte-for-byte except that
|
||||||
|
leading or trailing whitespace is ignored.
|
||||||
"""
|
"""
|
||||||
filename = input_stream.name
|
filename = input_stream.name
|
||||||
current_section = None
|
current_section = None
|
||||||
|
|
Loading…
Reference in a new issue