doxygen: rewrite set_canonical_doxygen.py in Perl

[fvanmaele]

Fixes issue #8735

---

The Perl script ends up slightly longer than the Python version. Using Tie::File would add brevity, it however has issues with UTF-8 encoded files. Most doxygen files are ascii encoded, but on my system (Ubuntu 18.04) there were some utf8 encoded as well.

The Perl version also correctly appends the canonical link precisely once; the Python version would not do this, due to setting the canonical_link_added inside the loop to False at every iteration.

I wasn't sure on style guidelines for Perl scripts, and as far as I know clang-format only applies to C++ source files. As such, I tried following the style of the other Perl scripts in the doc/doxygen/scripts directory.

---

This is a draft pull request since I'm still building and comparing all doxygen created files between set_canonical_doxygen.py and set_canonical_doxygen.pl (and some remarks pointed out below).

[fvanmaele]

I've compared two copies of the dealii directory, one with this PR applied, and another from master (dealii-orig).

Apart from header.html, the generated files are identical between set_canonical_doxygen.py and set_canonical_doxygen.pl. (Full diff with path changes.)

[drwells]

I am not fluent in perl but the script looks reasonable and produces the correct output. Since this is just a doc change lets merge.

[fvanmaele]

Thanks!

…

On 9/30/19 8:41 PM, David Wells wrote: Merged #8736 <#8736> into master. — You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub <#8736?email_source=notifications&email_token=AJZNDW7WB4JQPEPQCJMIJGDQMJB5FA5CNFSM4IVTVEVKYY3PNVWWK3TUL52HS4DFWZEXG43VMVCXMZLOORHG65DJMZUWGYLUNFXW5KTDN5WW2ZLOORPWSZGOT5T2ABY#event-2674368519>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AJZNDW3AADXQFCIOGKOKNBTQMJB5FANCNFSM4IVTVEVA>.