Code refactoring, commening, and implement enough to have kdeconnect show as an option when adding an account!
ClosedPublic

Authored by sredman on May 23 2017, 4:32 AM.

Details

Summary

Add header comments to Presence emthods

Add header comment to curious 'messageReceived' signal

Add header comment to ConnectConnectoin::receiveMessage

Add header comments to Presence emthods

Add header comment to curious 'messageReceived' signal

Add .arcconfig

Add more header comments, including to file header

Remove ability to add contacts via telepathy plugin

Adding a contact in the desktop has the assumption that this contact will appear on the phone. I would like to make sure this assumption doesn't hold by having the plugin report that the contacts book is non-modifiable

Move enabling warnings and debug to main.cpp

Add protocol specifications to manager file

Add protocol definitions to protocol implementation

Begin the long journey of removing kdeconnecttelepathyprotocolfactory, as it is probably unneeded once the account adding is properly set up

Add required 'device_id' parameter to hacked-in account

Add dummy profile file

Officially change name from connectcm to telepathy-kdeconnect

Reenable the ability to set account online and offline manually (even though it's currently meaningless)

Remove duplicate parameter from .manager file

Diff Detail

Repository
R716 Telepathy KDE Connect Integration
Lint
Automatic diff as part of commit; lint not applicable.
Unit
Automatic diff as part of commit; unit tests not applicable.
sredman created this revision.May 23 2017, 4:32 AM
apol added a subscriber: apol.May 23 2017, 9:43 AM

Other than that, LGTM.
I'm not all that into telepathy connection managers though.

CMakeLists.txt
16

Ugh no, don't do that. Rename it if you want, but don't pass the name with a variable.
Better be explicit.

connection.cpp
175

You added one comment in the cpp and the other on the header. Please do the same on both.

sredman updated this revision to Diff 14793.May 24 2017, 1:29 AM

Code refactoring, commening, and implement enough to have kdeconnect show as an option when adding an account!

sredman marked an inline comment as done.May 24 2017, 1:32 AM
sredman added inline comments.
CMakeLists.txt
16

Thank you for the feedback! I have never used CMake before, so I have not seen the failure case using a variable for the outputs would cause. Do you have a horror story (which you would like to share), or is this just general good practice?

connection.cpp
175

Do you mean I should have, for method-header comments, the same thing in both the .h and .cpp files? The reason I don't want to do this (at least not at present) is that everything is changing quite rapidly. It would be hard to keep the two sets of comments in sync (and they would surely get out of sync)

To that end, I have been keeping all my header comments in the .cpp file. The comment in the .h file for the messageReceived(..) signal is only in the .h file because it doesn't appear in the .cpp

In general, I like using something like doxygen to keep track of comments regardless. This solves the problem of wondering whether a header comment belongs in the source or header file, because it is easier and nicer-looking to refer to the doxygen output in any case. I have added a Doxyfile (and the related output to the .gitignore)

apol accepted this revision.May 31 2017, 1:55 PM
This revision is now accepted and ready to land.May 31 2017, 1:55 PM
This revision was automatically updated to reflect the committed changes.