Hacker News new | ask | show | jobs
by forgotmypw17 1000 days ago
I'd like to add another comment type to this list, which is searchable #topics and alternative procedure names.

For example, if there's a feature around replies, I may put #replies in the key places in the code. If some code takes part in generating replies.html, I might put "#replies.html" as a comment.

A lot of my procedures have comments with alternative names aliased underneath:

    sub SqliteQueryHashRef { # $query, @queryParams; calls sqlite with query, and returns result as array of hashrefs
    #sub SqliteGetHash {
    #sub SqliteGetHashRef {
    #sub SqliteGetQueryHashRef {
    #sub SqliteGetQuery {
    #sub GetQuery {
    #sub GetQueryAsHash {
    #sub GetQueryAsArray {
    #sub GetQueryAsArrayOfHashRefs {
Each of these represents a time in the past when I went into the global find tool and searched for e.g. "GetQuery ", didn't find anything, and then eventually tracked down this procedure.

BTW, if you only put a space after the procedure name in its definition, its much easier to search for.