DocumentationOrganization
ActivePublic

Recent Activity

Thu, Jan 23

asensi closed D26817: Change docbooks in order to make Krusader build at least under (K)Ubuntu 18.04 LTS and in docs.kde.org.
Thu, Jan 23, 10:03 PM · Krusader, Documentation
asensi retitled D26817: Change docbooks in order to make Krusader build at least under (K)Ubuntu 18.04 LTS and in docs.kde.org from Change docbooks in order to make Krusader build at least under Kubuntu/Ubuntu 18.04 LTS to Change docbooks in order to make Krusader build at least under (K)Ubuntu 18.04 LTS and in docs.kde.org.
Thu, Jan 23, 9:43 PM · Krusader, Documentation
kossebau closed D26602: Define K_DOXYGEN as macro to check if kapidox/doxygen is run.
Thu, Jan 23, 11:20 AM · Documentation, Frameworks
yurchor accepted D26817: Change docbooks in order to make Krusader build at least under (K)Ubuntu 18.04 LTS and in docs.kde.org.
Thu, Jan 23, 6:59 AM · Krusader, Documentation

Wed, Jan 22

asensi updated the diff for D26817: Change docbooks in order to make Krusader build at least under (K)Ubuntu 18.04 LTS and in docs.kde.org.

The changes suggested by Yuri Chornoivan were made.

Wed, Jan 22, 9:41 PM · Krusader, Documentation
yurchor added a comment to D26817: Change docbooks in order to make Krusader build at least under (K)Ubuntu 18.04 LTS and in docs.kde.org.

This can be solved much more easily without breaking translations by adding entities into index.docbook header (~line 27):

Wed, Jan 22, 6:38 AM · Krusader, Documentation

Tue, Jan 21

asensi requested review of D26817: Change docbooks in order to make Krusader build at least under (K)Ubuntu 18.04 LTS and in docs.kde.org.
Tue, Jan 21, 10:20 PM · Krusader, Documentation

Sun, Jan 19

asturmlechner added a comment to D26306: Define more documentation search paths (also custom).

Thanks for that, works for me!

Sun, Jan 19, 7:24 PM · Documentation, Frameworks

Sat, Jan 18

ognarb moved T2442: Make docs.kde.org website translatable from other stuff to incoming on the Websites board.
Sat, Jan 18, 10:23 PM · Websites, Documentation

Fri, Jan 17

kossebau closed D26652: Unbreak module imports for Python2.
Fri, Jan 17, 1:11 PM · Documentation, Frameworks
kossebau closed D26661: Hardcode utf-8 as filesystem encoding with Python2 to help api.kde.org.
Fri, Jan 17, 1:10 PM · Documentation, Frameworks

Thu, Jan 16

kossebau added a comment to D26602: Define K_DOXYGEN as macro to check if kapidox/doxygen is run.

No one any opinion? Guess most people have not run into the need to do pre-processor switches for the doc generation, and also never seen DOXYGEN_SHOULD_SKIP_THIS before.

Thu, Jan 16, 10:59 AM · Documentation, Frameworks
broulik closed D26684: [Notifications KCM] Add docbook for new KCM.
Thu, Jan 16, 9:27 AM · Documentation, Plasma

Wed, Jan 15

asensi added a comment to D26291: rework of keyboard widgets focus.

The base of the idea is good, although after applying changes... Krusader users are not able to keep using the handy Ctrl+ and Ctrl+ to move focus even if they redefine the Move Focus Up and Move Focus Down keys :-?

Wed, Jan 15, 10:49 PM · Krusader, Documentation
yurchor accepted D26684: [Notifications KCM] Add docbook for new KCM.

Thanks.

Wed, Jan 15, 2:32 PM · Documentation, Plasma
broulik updated the diff for D26684: [Notifications KCM] Add docbook for new KCM.
  • Fix wording
Wed, Jan 15, 2:19 PM · Documentation, Plasma
yurchor added a comment to D26684: [Notifications KCM] Add docbook for new KCM.

Thanks for fixing this minor typo.

Wed, Jan 15, 11:46 AM · Documentation, Plasma
broulik updated the test plan for D26684: [Notifications KCM] Add docbook for new KCM.
Wed, Jan 15, 9:16 AM · Documentation, Plasma
broulik requested review of D26684: [Notifications KCM] Add docbook for new KCM.
Wed, Jan 15, 9:16 AM · Documentation, Plasma
davidedmundson accepted D26652: Unbreak module imports for Python2.
Wed, Jan 15, 8:44 AM · Documentation, Frameworks
kossebau added a comment to D26652: Unbreak module imports for Python2.

Last night's run of api.kde.org generation with kapidox locally patched with this change worked again,
So unless there are objections will push then latest next WE, though happy to have people give green light before :)

Wed, Jan 15, 7:32 AM · Documentation, Frameworks

Tue, Jan 14

kossebau updated the diff for D26661: Hardcode utf-8 as filesystem encoding with Python2 to help api.kde.org.

fix comment locale -> filesystem encoding

Tue, Jan 14, 12:55 PM · Documentation, Frameworks
kossebau added a comment to D26661: Hardcode utf-8 as filesystem encoding with Python2 to help api.kde.org.

D22836 was tried before to fix this, but later it was found this still did not work on api.kde.org. At that time I had added some local patches on api.kde.org itself, but not getting further at one point forgot about things sadly.

Tue, Jan 14, 12:53 PM · Documentation, Frameworks
kossebau requested review of D26661: Hardcode utf-8 as filesystem encoding with Python2 to help api.kde.org.
Tue, Jan 14, 12:48 PM · Documentation, Frameworks
kossebau updated the diff for D26652: Unbreak module imports for Python2.

Brown paper bag for me: if one changes code, they should also see to trigger
that code, in this case passing the --depdiagram-dot-dir arg to
kapidox_generate...

Tue, Jan 14, 12:01 PM · Documentation, Frameworks
kossebau added a comment to D26652: Unbreak module imports for Python2.

For now, given @bcooksley's comment going to try some simple change to 'from kapidox.depdiagram import gvutils', this is a pattern found elsewhere in the old code. Will do a local patch to the checkout on the server and see if this has any effect on next cron job run. So far that also worked for all the 3 situations I tested (local python3 & python2, python2 on server test env).

Tue, Jan 14, 11:33 AM · Documentation, Frameworks
kossebau added a comment to D26652: Unbreak module imports for Python2.

To add to my confusion, running the unpatched version works with my local 2.7.17 python interpreter (checked with print (sys.version)) and worse, running things manually on api.kde.org in some test subdir also works with its 2.7.15...

Tue, Jan 14, 11:05 AM · Documentation, Frameworks
kossebau added inline comments to D26652: Unbreak module imports for Python2.
Tue, Jan 14, 9:28 AM · Documentation, Frameworks
bcooksley added inline comments to D26652: Unbreak module imports for Python2.
Tue, Jan 14, 9:19 AM · Documentation, Frameworks
kossebau added a comment to D26652: Unbreak module imports for Python2.

Because the very user api.kde.org right now in production still uses python2 sadly. And replacing that server with something modern is sadly not a few-hours job, still waiting for someone to spend the weeks on getting a substitution done.

Tue, Jan 14, 9:06 AM · Documentation, Frameworks
awilcox added a comment to D26652: Unbreak module imports for Python2.

Why should Python 2 continue to be supported, after its EOL on 2020-01-01?

Tue, Jan 14, 8:49 AM · Documentation, Frameworks
kossebau added a comment to D25632: Fix module imports with Python3.

D26652 now up as proposal to fix this

Tue, Jan 14, 8:33 AM · Documentation, Frameworks
kossebau requested review of D26652: Unbreak module imports for Python2.
Tue, Jan 14, 8:33 AM · Documentation, Frameworks
kossebau added a comment to D25632: Fix module imports with Python3.

No python developer myself, but from patterns seen I guess the imports should have some

if sys.version_info.major < 3:
    // python2 import style
else:
    // python3 import style

?

Tue, Jan 14, 6:06 AM · Documentation, Frameworks
kossebau added a comment to D25632: Fix module imports with Python3.

Hi. Sadly api.kde.org failed to pick this change up until yesterday, as I had forgotten a change in the local checkout on my last work on the server, which then blocked the update via scripted git pull.
That I fixed partially yesterday, making sure latest KApiDox is run on api.kde.org, but that showed that gentoo(?) server running api.kde.org does not like yet this new code:

Traceback (most recent call last):
  File "/home/api/kapidox/src/kapidox_generate", line 110, in <module>
    main()
  File "/home/api/kapidox/src/kapidox_generate", line 106, in main
    copyright=kde_copyright)
  File "/home/api/kapidox/src/kapidox/hlfunctions.py", line 108, in do_it
    dot_files, tmp_dir)
  File "/home/api/kapidox/src/kapidox/generator.py", line 646, in generate_diagram
    with_qt=with_qt)
  File "/home/api/kapidox/src/kapidox/depdiagram/generate.py", line 156, in generate
    db.populate(dot_files, with_qt=with_qt)
  File "/home/api/kapidox/src/kapidox/depdiagram/frameworkdb.py", line 175, in populate
    fw = parser.parse(tier, dot_file)
  File "/home/api/kapidox/src/kapidox/depdiagram/frameworkdb.py", line 115, in parse
    dot_data =  preprocess(dot_file)
  File "/home/api/kapidox/src/kapidox/depdiagram/frameworkdb.py", line 75, in preprocess
    for node_handle in gvutils.get_node_list(graph_handle):
NameError: global name 'gvutils' is not defined

From https://api.kde.org/logs/api/frameworks/frameworks5.log

Tue, Jan 14, 5:53 AM · Documentation, Frameworks

Sun, Jan 12

kossebau added a comment to D26602: Define K_DOXYGEN as macro to check if kapidox/doxygen is run.

Some similar macro definitions used by other projects, as I found by doing some random grepping over my system includes:

  • __GTK_DOC_IGNORE__
  • Q_QDOC & Q_CLANG_QDOC
  • DO_NOT_DOCUMENT
  • EIGEN_PARSED_BY_DOXYGEN
  • DOXYGEN
  • U_IN_DOXYGEN
  • BOOST_DOXYGEN_INVOKED & lots of similar
  • CV_DOXYGEN
  • DOXYGEN_ENABLED
Sun, Jan 12, 10:45 AM · Documentation, Frameworks
kossebau requested review of D26602: Define K_DOXYGEN as macro to check if kapidox/doxygen is run.
Sun, Jan 12, 10:40 AM · Documentation, Frameworks

Sat, Jan 11

ognarb added a comment to D25928: Port doc generator to python 3.

Thanks for the review :)

Sat, Jan 11, 3:57 PM · Documentation
ognarb closed D25928: Port doc generator to python 3.
Sat, Jan 11, 3:57 PM · Documentation
ltoscano accepted D25928: Port doc generator to python 3.

Thanks!

Sat, Jan 11, 3:44 PM · Documentation
ognarb updated the test plan for D25928: Port doc generator to python 3.
Sat, Jan 11, 2:51 PM · Documentation
ltoscano added a comment to D25928: Port doc generator to python 3.

Accepted if you amend the commit message; the full log from the build generation is probably overkill.

Sat, Jan 11, 1:13 PM · Documentation
adrianchavesfernandez accepted D25928: Port doc generator to python 3.
Sat, Jan 11, 11:44 AM · Documentation

Thu, Jan 9

yurchor added a comment to D26190: Fix man page formatting.

Should be fixed in stable for now.

Thu, Jan 9, 7:41 PM · Documentation, Okular
yurchor added a comment to D26190: Fix man page formatting.

Very few people know about this problem (es, nl, pt, pt_BR). And even some those who do know just forgot to update the docbook (de, uk). Some docbooks cannot be updated because the translations are now incomplete (et, fr, ru). Thus there should be some coordinated effort to fix this from the translator side.

Thu, Jan 9, 7:14 PM · Documentation, Okular
aacid added a comment to D26190: Fix man page formatting.

I guess the translators need to re-generate them

Thu, Jan 9, 7:00 PM · Documentation, Okular
arojas added a comment to D26190: Fix man page formatting.

The localized man pages are still broken in 19.12.1 - what does it need to happen for them to pick up the change?

Thu, Jan 9, 6:35 PM · Documentation, Okular

Thu, Jan 2

ltoscano triaged T12482: Documentation generation is stuck with an old kdoctools as High priority.
Thu, Jan 2, 6:55 PM · Documentation

Wed, Jan 1

mlaurent closed D26317: Port endl to "\n". endl in qt5.15 is namespaced. We don't need to flush as when QFile is deleted it flush data.
Wed, Jan 1, 1:30 PM · Documentation, Frameworks
aacid accepted D26317: Port endl to "\n". endl in qt5.15 is namespaced. We don't need to flush as when QFile is deleted it flush data.
Wed, Jan 1, 12:04 PM · Documentation, Frameworks