[tor-bugs] #4893 [Tor Client]: Rename inconsistent function and type names
Tor Bug Tracker & Wiki
torproject-admin at torproject.org
Wed Jan 11 20:21:33 UTC 2012
#4893: Rename inconsistent function and type names
------------------------+---------------------------------------------------
Reporter: nickm | Owner:
Type: defect | Status: new
Priority: normal | Milestone: Tor: 0.2.3.x-final
Component: Tor Client | Version:
Keywords: | Parent:
Points: | Actualpoints:
------------------------+---------------------------------------------------
By convention:
* Types do not have "`env`" or "object`" or whatever in them.
* The primary function to free a foo is called `foo_free()`, not
`foo_free_env()`.
* The primary function that allocates and returns a newly allocated foo
is called `foo_new()`, not `foo_create()` or `foo_new_env()`.
We violate these rules, though, with a fair number of longstanding types
and identifiers. How annoying! Let's fix that.
This will make some pending unmerged code get merge conflicts or need
rewrites, but now that we're moving towards the end of the 0.2.3.x release
cycle, it's the perfect time to do that.
--
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/4893>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online
More information about the tor-bugs
mailing list