Hello,
I recently started looking at the org-set-tags function in org.el, but then quickly got confused with the doc-string.
"Set the tags for the current headline.
With prefix ARG, realign all tags in headings in the current buffer.
When JUST-ALIGN is non-nil, only align tags."
The purpose of ARG and JUST-ALIGN seems to be the exact same from the doc-string. On reading the code, I realized that actually ARG should have been called JUST-ALIGN and the JUST-ALIGN should have been called ALIGN-ONLY-CURRENT.
The attached patch contains the updated doc-string, refactoring of the argument names, and renaming of the argument symbol to :align-only-current from 'align and 'ignore-column in org-set-tag calls. I have left most of the org-set-tags calls untouched where the argument values are simply t instead of descriptive 'align or 'ignore-column.
As the patch introduces no functional changes, I have based it off maint. "make test" is still passing with these changes.
Can you please review the patch and let me know if it's good for committing?
Thanks.
0001-Clarify-the-purpose-of-org-set-tags-arguments.patch