Skip to content

Conversation

moste00
Copy link

@moste00 moste00 commented Jul 18, 2025

Your checklist for this pull request

  • I've documented or updated the documentation of every API function and struct this PR changes.
  • I've added tests that prove my fix is effective or that my feature works (if possible)

Detailed description

I added a warning for both the README and the refactor guide that things only work on Linux, also added a tip about llvm-symbolizer to prettify the stacktraces that might result when you run commands that end up with LLVM tools crashing

Some miscellenous clarifications and additions were added, I expect I might update this PR so you might want to leave it unmerged for a couple of days to bundle all the changes together

Test plan

...

Closing issues

...

@github-actions github-actions bot added documentation Improvements or additions to documentation Auto-Sync-files labels Jul 18, 2025
Copy link
Owner

@Rot127 Rot127 left a comment

Choose a reason for hiding this comment

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

Please just change those few things.


## Install

> ⚠️
Copy link
Owner

Choose a reason for hiding this comment

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

Please use the Github markdown highlighting for this:
https://github.com/orgs/community/discussions/16925

- Always attempt to make the translated C file behave as closely as possible to the original C++ file! This greatly helps debugging and assures that Capstone behaves almost exactly the same as original LLVM.


> ⚠️
Copy link
Owner

Choose a reason for hiding this comment

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

Also here

## Install

> ⚠️
> Auto-Sync only runs on Linux, running on Windows is desirable but not a priority at the moment
Copy link
Owner

Choose a reason for hiding this comment

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

Better just state it and link the issue: capstone-engine#2755.
So people have a place to check for updates and complain. Also below.



> ⚠️
> Refactoring an architecture to Auto-Sync is only possible on Linux, running on Windows is desirable but not a priority at the moment
Copy link
Owner

Choose a reason for hiding this comment

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Auto-Sync-files documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants