Minor documentation improvements

This commit is contained in:
Gilles Peskine 2020-01-22 12:43:29 +01:00
parent f296cdb2ab
commit 974232f045

View File

@ -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