Skip to content

Commit

Permalink
Update documentation for v1.0.0 release.
Browse files Browse the repository at this point in the history
Further updates to the README.md file.

Add more to the README.md file.

Add more documentation to README.md.

More documentation in README.md

Start documenting addressing modes in README.md

Final set of changes to README.md file.
  • Loading branch information
craigthomas committed Sep 24, 2022
1 parent 6d930e4 commit a1d1c3f
Show file tree
Hide file tree
Showing 30 changed files with 462 additions and 107 deletions.
2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
Copyright (C) 2013-2019 Craig Thomas
Copyright (C) 2013-2022 Craig Thomas

Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
Expand Down
506 changes: 430 additions & 76 deletions README.md

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion assembler.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2019-2020 Craig Thomas
Copyright (C) 2013-2022 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand Down
2 changes: 1 addition & 1 deletion cocoasm/exceptions.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2022 Craig Thomas
Copyright (C) 2013-2022 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
This file contains Exceptions for the CoCo Assembler.
Expand Down
2 changes: 1 addition & 1 deletion cocoasm/instruction.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2022 Craig Thomas
Copyright (C) 2013-2022 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand Down
2 changes: 1 addition & 1 deletion cocoasm/operand_type.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2022 Craig Thomas
Copyright (C) 2013-2022 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand Down
2 changes: 1 addition & 1 deletion cocoasm/operands.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2019-2020 Craig Thomas
Copyright (C) 2013-2020 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand Down
2 changes: 1 addition & 1 deletion cocoasm/program.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2022 Craig Thomas
Copyright (C) 2013-2022 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
This file contains the main Program class for the CoCo Assembler.
Expand Down
2 changes: 1 addition & 1 deletion cocoasm/statement.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2019-2020 Craig Thomas
Copyright (C) 2013-2020 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand Down
2 changes: 1 addition & 1 deletion cocoasm/values.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2019-2020 Craig Thomas
Copyright (C) 2013-2020 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand Down
2 changes: 1 addition & 1 deletion cocoasm/virtualfiles/binary.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2022 Craig Thomas
Copyright (C) 2013-2022 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand Down
2 changes: 1 addition & 1 deletion cocoasm/virtualfiles/cassette.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2022 Craig Thomas
Copyright (C) 2013-2022 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand Down
2 changes: 1 addition & 1 deletion cocoasm/virtualfiles/coco_file.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2022 Craig Thomas
Copyright (C) 2013-2022 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand Down
2 changes: 1 addition & 1 deletion cocoasm/virtualfiles/disk.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2022 Craig Thomas
Copyright (C) 2013-2022 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand Down
2 changes: 1 addition & 1 deletion cocoasm/virtualfiles/source_file.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2022 Craig Thomas
Copyright (C) 2013-2022 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand Down
2 changes: 1 addition & 1 deletion cocoasm/virtualfiles/virtual_file.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2019-2020 Craig Thomas
Copyright (C) 2013-2020 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand Down
2 changes: 1 addition & 1 deletion cocoasm/virtualfiles/virtual_file_container.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2022 Craig Thomas
Copyright (C) 2013-2022 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand Down
2 changes: 1 addition & 1 deletion cocoasm/virtualfiles/virtual_file_exceptions.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2022 Craig Thomas
Copyright (C) 2013-2022 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
This file contains Exceptions for the CoCo Assembler.
Expand Down
2 changes: 1 addition & 1 deletion file_util.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2019-2020 Craig Thomas
Copyright (C) 2013-2020 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand Down
2 changes: 1 addition & 1 deletion test/test_exceptions.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2019-2022 Craig Thomas
Copyright (C) 2013-2022 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand Down
2 changes: 1 addition & 1 deletion test/test_integration.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2022 Craig Thomas
Copyright (C) 2013-2022 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
This file contains the main Program class for the CoCo Assembler.
Expand Down
2 changes: 1 addition & 1 deletion test/test_operands.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2019-2020 Craig Thomas
Copyright (C) 2013-2020 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand Down
2 changes: 1 addition & 1 deletion test/test_program.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2022 Craig Thomas
Copyright (C) 2013-2022 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
This file contains the main Program class for the CoCo Assembler.
Expand Down
4 changes: 2 additions & 2 deletions test/test_statement.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2022 Craig Thomas
Copyright (C) 2013-2022 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand All @@ -10,7 +10,7 @@

from cocoasm.statement import Statement
from cocoasm.values import NumericValue, AddressValue
from cocoasm.exceptions import ParseError, OperandTypeError, TranslationError
from cocoasm.exceptions import ParseError, TranslationError

# C L A S S E S ###############################################################

Expand Down
4 changes: 2 additions & 2 deletions test/test_values.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2019-2020 Craig Thomas
Copyright (C) 2013-2020 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand Down Expand Up @@ -589,7 +589,7 @@ def test_expression_resolve_symbol_subtraction_works_correctly(self):
result = result.resolve(symbol_table)
self.assertEqual(result.int, 1)

def test_expression_resolve_numeric_only_division_works_correctly(self):
def test_expression_resolve_symbol_plus_numeric_division_works_correctly(self):
symbol_table = {"VAR": NumericValue("$04", mode=ExplicitAddressingMode.DIRECT)}
result = ExpressionValue("VAR/2")
result = result.resolve(symbol_table)
Expand Down
3 changes: 2 additions & 1 deletion test/virtualfiles/test_binary.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2022 Craig Thomas
Copyright (C) 2013-2022 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand Down Expand Up @@ -97,6 +97,7 @@ def test_list_files_returns_empty_list(self):
binary_file = BinaryFile()
self.assertEqual([], binary_file.list_files())


# M A I N #####################################################################

if __name__ == '__main__':
Expand Down
2 changes: 1 addition & 1 deletion test/virtualfiles/test_cassette.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2022 Craig Thomas
Copyright (C) 2013-2022 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand Down
2 changes: 1 addition & 1 deletion test/virtualfiles/test_coco_file.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2022 Craig Thomas
Copyright (C) 2013-2022 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand Down
2 changes: 1 addition & 1 deletion test/virtualfiles/test_disk.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2022 Craig Thomas
Copyright (C) 2013-2022 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand Down
2 changes: 1 addition & 1 deletion test/virtualfiles/test_source_file.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
"""
Copyright (C) 2022 Craig Thomas
Copyright (C) 2013-2022 Craig Thomas
This project uses an MIT style license - see LICENSE for details.
A Color Computer Assembler - see the README.md file for details.
Expand Down

0 comments on commit a1d1c3f

Please sign in to comment.