allow copying example code from docs.wxwidgets.org

[wxtrac]

Issue migrated from trac ticket # 16748

component: documentation | priority: low

2014-12-28 02:31:43: krichter (Kalle Richter) created the issue

---

Some example code from docs.wxwidgets.org don't allow copying because the line numbers are included in the copied text which causes time waisting during removal, e.g. http://docs.wxwidgets.org/stable/overview_python.html. The availability of source as file doesn't help because downloading the source, opening a file browser and the file takes ~100 times longer than copy-pasting.

[wxtrac]

2014-12-28 02:34:31: @vadz changed priority from normal to low

2014-12-28 02:34:31: @vadz changed status from new to confirmed

2014-12-28 02:34:31: @vadz commented

Having line numbers is useful because they're referred to in the code and I don't really know how to allow copying the text without them, considering that this is generated by Doxygen. IOW it's very unlikely that this is going to be changed unless someone knows how it can be done and, ideally, actually does it.

[wxtrac]

2014-12-28 03:31:30: krichter (Kalle Richter) commented

---

OK, it's really just a sidenote. Having the line numbers toggable in javascript on the website would be ideal (e.g. like on http://tkinter.unpythonic.net/wiki/TkTable).

[wxtrac]

2014-12-28 04:55:14: @tierra commented

---

Actually, none of them have line numbers by default. This specific case happened because the original manually added them from the old docs: https://github.com/wxWidgets/wxWidgets/blob/master/docs/doxygen/overviews/python.h#L134-L207

So none of them are generated by Doxygen, however VZ is correct, they were left in there since the docs do refer to specific line numbers.

Leaving this open though since it's possible to include a better highlighting feature in the future if someone cares enough to look into it, and maybe Doxygen will do so itself down the road.

[vadz]

Just FTR, this is supported by an extension to the doxygen theme discussed in #18849.