• Danilo Cesar Lemes de Paula's avatar
    scripts/kernel-doc: Replacing highlights hash by an array · 4d732701
    Danilo Cesar Lemes de Paula authored
    The "highlight" code is very sensible to the order of the hash keys,
    but the order of the keys cannot be predicted. It generates
    faulty DocBook entries like:
    	- @<function>device_for_each_child</function>
    
    Sorting the result is not enough some times (as it's deterministic but
    we can't control it).
    We should use an array for that job, so we can guarantee that the order
    of the regex execution on dohighlight is correct.
    
    [jc: I think this is kind of papering around the real problem, that people
     are saying @function() when "function" is not a parameter.  But this makes
     things better than they were before, so...]
    Signed-off-by: default avatarDanilo Cesar Lemes de Paula <danilo.cesar@collabora.co.uk>
    Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
    4d732701
kernel-doc 75.4 KB