[fs.op.funcs] has 39 immediately-nested subclauses
Open
Nobody has claimed this yet.
- Dominant language
- TeX
- Stars
- 221
- Forks
- 813
- Avg merge
- 16h 4m
- Merged PRs (30d)
- 36
Description
And most of the subclauses describe just one function, or two at best.
Ideas for more structure:
- Introduce subclauses "file properties" (exists, is_directory etc.), "modifiers" (rename, copy), "path operations" (canonical etc.), "others"
- Compactify the description of is_blah; the only difference between these functions is the file_status::type() result value that is checked.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Locate the [fs.op.funcs] section in the TeX sources and inspect its 39 immediately nested subclauses, especially the descriptions of the is_blah functions. Reorganize the clauses into clearer groups and reduce repeated descriptions where appropriate; done means the section has a more useful structure without losing any function coverage.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- tex
- Domain
- documentation
- Issue type
- Refactor
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100