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

Updater: Add code documentation #9615

Merged
merged 1 commit into from May 7, 2021

Conversation

Dentomologist
Copy link
Contributor

Add a comment at the beginning of AutoUpdate.h giving an overview of
the update process and how the flow of control proceeds during an
update.

// a) On MacOS (starts main() in MacUpdater/main.m):
// * Checks that the process received command line arguments. If not it tells the user the
// updater can't be launched directly and quits
// * Calls NSApplicationMain(), which passes control to the AppDelegate defined in
// MacUpdater/AppDelegate.mm. The command line arguments are converted to a std::vector
// and passed to RunUpdater() in UpdaterCommon.h
Copy link
Contributor Author

Choose a reason for hiding this comment

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

I'm not familiar with Objective-c so I'm not certain about this part, but it should be something close.

@Rumi-Larry
Copy link

Rumi-Larry commented Mar 31, 2021

It would be better to add this as a separate readme file, and citing that file inside the cpp and h files

@Dentomologist
Copy link
Contributor Author

Documentation moved to docs/autoupdate_overview.txt, with comments thereto in autoupdate related classes.

@Rumi-Larry
Copy link

Documentation moved to docs/autoupdate_overview.txt, with comments thereto in autoupdate related classes.

Good, is it necessary to cite the document in the mac updater files too?

Add docs/autoupdate_overview.md which gives an overview of the update
process, and comments pointing to it in autoupdate related files.
@Dentomologist
Copy link
Contributor Author

  • Converted text file to Markdown
  • Added documentation pointer comments to MacUpdater/AppDelegate.mm, MacUpdater/main.m, and WinUpdater/Main.cpp
  • Updated existing comments to reflect change from .txt to .md
  • Fixed linter issue in MacUpdater/AppDelegate.mm

@leoetlino leoetlino merged commit 8547de2 into dolphin-emu:master May 7, 2021
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
3 participants