Skip to content
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

Add comments to commands for clarity #68

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

boisy
Copy link
Collaborator

@boisy boisy commented Jan 14, 2025

No description provided.

level1/cmds/echo.asm Show resolved Hide resolved
level1/cmds/list.asm Show resolved Hide resolved
Comment on lines -31 to +29
edition set 22
edition set 23
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I can't tell if this is a pure comment update or if it has actual code changes that might break something and therefore needs an edition revision. Which is it?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

See my comment below.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would say if it's a pure (micro-)optimization that shouldn't be able to break anything, there's probably no need for a new edition.

But that's also why it's not great to make code and formatting (like comments) changes at the same time, because the tiny code update/fix/etc. that actually alters the binary gets hidden by the big line count changes that don't.

level1/cmds/echo.asm Show resolved Hide resolved
level1/cmds/list.asm Show resolved Hide resolved
bra L0069
bne ExitShell exit shell if so
noparms@ lds ,s++ get Y off stack pushed earlier (end of parameter area)
ProcLine tst <suppressintro do we suppress showing the intro?
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Deek a subtle optimization... I now test the "supressintro" flag before setting X two lines down. The other code set X first and then did the test. It may not justify incrementing the edition byte. Let me know what you think.

Comment on lines -31 to +29
edition set 22
edition set 23
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

See my comment below.

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.

2 participants