Kalzium Contribution

Thu Dec 11 09:58:21 UTC 2014

On Thu, Dec 11, 2014 at 11:14 AM, Shalin Shah <shalinshah1993 at gmail.com> wrote:
> Hey,
>
> Imported it in Qt Creator. Re-ran the CMAKE with arguments and bingo,
> Kalzium is working just fine. Now, I'm interested in fixing bugs and adding
> features.
>
> Like yesterday I was suggested on IRC to fix bug 334789. Now, before fixing
> bug I need to understand the code. So, is there any documentation or
> something which I can read so that I can understand which .cpp file does
> what function?
>

To understand the code, you need to read through it and try and
understand the control flow. The header and the corresponding
.cpp files should be having reasonable amount of documentation.
If you feel any portion of the code is under-documented, you are
welcome to add documentation yourself. However, do follow the
documentation policy [1]. Also if you have difficulty with specific
sections of the codebase, you can surely find help from Kalzium
developers.

Happy hacking.

> Yours Sincerely,
> Shalin Shah
>
> On Thu, Dec 11, 2014 at 10:35 AM, Shalin Shah <shalinshah1993 at gmail.com>
> wrote:
>>
>> Ok, so all the build steps are done? If so, now, I guess I'll have to
>> import it to Qt Creator right?
>>
>> Yours Sincerely,
>> Shalin Shah
>>
>> On Thu, Dec 11, 2014 at 10:33 AM, Jeremy Whiting <jpwhiting at kde.org>
>> wrote:
>>>
>>> Now run it and find and fix bugs I guess. The next step is up to you
>>> really, what would you like to do?
>>>
>>> On Wed, Dec 10, 2014 at 10:02 PM, Shalin Shah <shalinshah1993 at gmail.com>
>>> wrote:
>>>>
>>>> Alright! I guess that worked, though I needed root privileges to run
>>>> make install.
>>>>
>>>> Now, what next?
>>>>
>>>> Yours Sincerely,
>>>> Shalin Shah
>>>>
>>>> On Thu, Dec 11, 2014 at 10:15 AM, Jeremy Whiting <jpwhiting at kde.org>
>>>> wrote:
>>>>>
>>>>> Yep, I can't remember why ubuntu and debian named their kdelibs 4
>>>>> packages kdelibs5 but you want kdelibs5-dev to build kalzium master branch
>>>>> which is based on kdelibs4 and qt4.
>>>>>
>>>>> On Wed, Dec 10, 2014 at 9:37 PM, Shalin Shah <shalinshah1993 at gmail.com>
>>>>> wrote:
>>>>>>
>>>>>> So, I did apt-cache search kdelibs but I get kdelibs5 not 4. Here see
>>>>>> :
>>>>>>
>>>>>> shalin at Shalin-MacBookPro:~/kalzium/build > apt-cache search kdelibs
>>>>>> kdelibs-bin - core executables for KDE Applications
>>>>>> kdelibs5-data - core shared data for all KDE Applications
>>>>>> kdelibs5-dbg - debugging symbols for the KDE Development Platform
>>>>>> libraries
>>>>>> kdelibs5-dev - development files for the KDE Development Platform
>>>>>> libraries
>>>>>> kdelibs5-plugins - core plugins for KDE Applications
>>>>>> krosspython - Python module for Kross
>>>>>>
>>>>>> Yours Sincerely,
>>>>>> Shalin Shah
>>>>>>
>>>>>> On Thu, Dec 11, 2014 at 10:01 AM, Jeremy Whiting <jpwhiting at kde.org>
>>>>>> wrote:
>>>>>>>
>>>>>>> Yep, looks like you need kdelibs4 devel package in order to build
>>>>>>> kalzium. I'm not sure what the package is called on linux mint but you
>>>>>>> should be able to find it with apt-cache search kdelibs.
>>>>>>>
>>>>>>> On Wed, Dec 10, 2014 at 9:25 PM, Shalin Shah
>>>>>>> <shalinshah1993 at gmail.com> wrote:
>>>>>>>>
>>>>>>>> Hi,
>>>>>>>>
>>>>>>>> Yes, following that, I did clone the repository. Now, however, while
>>>>>>>> I was to do cmake I got an error. Please see this :
>>>>>>>>
>>>>>>>> shalin at Shalin-MacBookPro:~/kalzium/build > cmake ../
>>>>>>>> -- The C compiler identification is GNU 4.8.2
>>>>>>>> -- The CXX compiler identification is GNU 4.8.2
>>>>>>>> -- Check for working C compiler: /usr/bin/cc
>>>>>>>> -- Check for working C compiler: /usr/bin/cc -- works
>>>>>>>> -- Detecting C compiler ABI info
>>>>>>>> -- Detecting C compiler ABI info - done
>>>>>>>> -- Check for working CXX compiler: /usr/bin/c++
>>>>>>>> -- Check for working CXX compiler: /usr/bin/c++ -- works
>>>>>>>> -- Detecting CXX compiler ABI info
>>>>>>>> -- Detecting CXX compiler ABI info - done
>>>>>>>> CMake Error at /usr/share/cmake-2.8/Modules/FindKDE4.cmake:98
>>>>>>>> (message):
>>>>>>>>   ERROR: cmake/modules/FindKDE4Internal.cmake not found in
>>>>>>>>
>>>>>>>> /home/shalin/.kde/share/apps;/usr/share/mintkde-default-settings/kde4-profile/default/share/apps;/usr/share/kde4/apps
>>>>>>>> Call Stack (most recent call first):
>>>>>>>>   CMakeLists.txt:6 (find_package)
>>>>>>>>
>>>>>>>>
>>>>>>>> CMake Warning (dev) in CMakeLists.txt:
>>>>>>>>   No cmake_minimum_required command is present.  A line of code such
>>>>>>>> as
>>>>>>>>
>>>>>>>>     cmake_minimum_required(VERSION 2.8)
>>>>>>>>
>>>>>>>>   should be added at the top of the file.  The version specified may
>>>>>>>> be lower
>>>>>>>>   if you wish to support older CMake versions for this project.  For
>>>>>>>> more
>>>>>>>>   information run "cmake --help-policy CMP0000".
>>>>>>>> This warning is for project developers.  Use -Wno-dev to suppress
>>>>>>>> it.
>>>>>>>>
>>>>>>>> -- Configuring incomplete, errors occurred!
>>>>>>>> See also "/home/shalin/kalzium/build/CMakeFiles/CMakeOutput.log".
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>> Then I added the link of minimum cmake version in the CMakeList.txt
>>>>>>>> file and the error I got was as under -
>>>>>>>>
>>>>>>>> shalin at Shalin-MacBookPro:~/kalzium/build > cmake ../
>>>>>>>> CMake Error at /usr/share/cmake-2.8/Modules/FindKDE4.cmake:98
>>>>>>>> (message):
>>>>>>>>   ERROR: cmake/modules/FindKDE4Internal.cmake not found in
>>>>>>>>
>>>>>>>> /home/shalin/.kde/share/apps;/usr/share/mintkde-default-settings/kde4-profile/default/share/apps;/usr/share/kde4/apps
>>>>>>>> Call Stack (most recent call first):
>>>>>>>>   CMakeLists.txt:7 (find_package)
>>>>>>>>
>>>>>>>>
>>>>>>>> -- Configuring incomplete, errors occurred!
>>>>>>>> See also "/home/shalin/kalzium/build/CMakeFiles/CMakeOutput.log".
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>> Don't we have to set up KDE environment and all before building this
>>>>>>>> code?
>>>>>>>>
>>>>>>>> Yours Sincerely,
>>>>>>>> Shalin Shah
>>>>>>>>
>>>>>>>> On Thu, Dec 11, 2014 at 9:52 AM, Shalin Shah
>>>>>>>> <shalinshah1993 at gmail.com> wrote:
>>>>>>>>>
>>>>>>>>> Hi,
>>>>>>>>>
>>>>>>>>> Yes, following that I did clone the repository. Now, however, while
>>>>>>>>> I was t doing cmake I got an error.
>>>>>>>>>
>>>>>>>>> shalin at Shalin-MacBookPro:~/kalzium/build > cmake ../
>>>>>>>>> -- The C compiler identification is GNU 4.8.2
>>>>>>>>> -- The CXX compiler identification is GNU 4.8.2
>>>>>>>>> -- Check for working C compiler: /usr/bin/cc
>>>>>>>>> -- Check for working C compiler: /usr/bin/cc -- works
>>>>>>>>> -- Detecting C compiler ABI info
>>>>>>>>> -- Detecting C compiler ABI info - done
>>>>>>>>> -- Check for working CXX compiler: /usr/bin/c++
>>>>>>>>> -- Check for working CXX compiler: /usr/bin/c++ -- works
>>>>>>>>> -- Detecting CXX compiler ABI info
>>>>>>>>> -- Detecting CXX compiler ABI info - done
>>>>>>>>> CMake Error at /usr/share/cmake-2.8/Modules/FindKDE4.cmake:98
>>>>>>>>> (message):
>>>>>>>>>   ERROR: cmake/modules/FindKDE4Internal.cmake not found in
>>>>>>>>>
>>>>>>>>> /home/shalin/.kde/share/apps;/usr/share/mintkde-default-settings/kde4-profile/default/share/apps;/usr/share/kde4/apps
>>>>>>>>> Call Stack (most recent call first):
>>>>>>>>>   CMakeLists.txt:6 (find_package)
>>>>>>>>>
>>>>>>>>>
>>>>>>>>> CMake Warning (dev) in CMakeLists.txt:
>>>>>>>>>   No cmake_minimum_required command is present.  A line of code
>>>>>>>>> such as
>>>>>>>>>
>>>>>>>>>     cmake_minimum_required(VERSION 2.8)
>>>>>>>>>
>>>>>>>>>   should be added at the top of the file.  The version specified
>>>>>>>>> may be lower
>>>>>>>>>   if you wish to support older CMake versions for this project.
>>>>>>>>> For more
>>>>>>>>>   information run "cmake --help-policy CMP0000".
>>>>>>>>> This warning is for project developers.  Use -Wno-dev to suppress
>>>>>>>>> it.
>>>>>>>>>
>>>>>>>>> -- Configuring incomplete, errors occurred!
>>>>>>>>> See also "/home/shalin/kalzium/build/CMakeFiles/CMakeOutput.log".
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>> Then I added the link of minimum cmake version in the CMakeList.txt
>>>>>>>>> file and the error I got was as under -
>>>>>>>>>
>>>>>>>>> shalin at Shalin-MacBookPro:~/kalzium/build > cmake ../
>>>>>>>>> CMake Error at /usr/share/cmake-2.8/Modules/FindKDE4.cmake:98
>>>>>>>>> (message):
>>>>>>>>>   ERROR: cmake/modules/FindKDE4Internal.cmake not found in
>>>>>>>>>
>>>>>>>>> /home/shalin/.kde/share/apps;/usr/share/mintkde-default-settings/kde4-profile/default/share/apps;/usr/share/kde4/apps
>>>>>>>>> Call Stack (most recent call first):
>>>>>>>>>   CMakeLists.txt:7 (find_package)
>>>>>>>>>
>>>>>>>>>
>>>>>>>>> -- Configuring incomplete, errors occurred!
>>>>>>>>> See also "/home/shalin/kalzium/build/CMakeFiles/CMakeOutput.log".
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>>
>>>>>>>>> Also, I've attached the error log file with this email.
>>>>>>>>>
>>>>>>>>> Don't we have to set up KDE environment and all before building
>>>>>>>>> this code?
>>>>>>>>>
>>>>>>>>> Yours Sincerely,
>>>>>>>>> Shalin Shah
>>>>>>>>>
>>>>>>>>> On Thu, Dec 11, 2014 at 1:05 AM, Jeremy Whiting <jpwhiting at kde.org>
>>>>>>>>> wrote:
>>>>>>>>>>
>>>>>>>>>> Shalin,
>>>>>>>>>>
>>>>>>>>>> I thought the kstars building instructions would help. You clone
>>>>>>>>>> from anongit.kde.org/kalzium, build with
>>>>>>>>>> mkdir build && cd build && cmake ../ && make && make install
>>>>>>>>>>
>>>>>>>>>> It depends on eigen3 and some other libraries such as Qt4.
>>>>>>>>>>
>>>>>>>>>> BR,
>>>>>>>>>> Jeremy
>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>> On Wed, Dec 10, 2014 at 12:30 PM, Shalin Shah
>>>>>>>>>> <shalinshah1993 at gmail.com> wrote:
>>>>>>>>>>>
>>>>>>>>>>> Hello,
>>>>>>>>>>>
>>>>>>>>>>> I'm a senior at DA-IICT, India and I'm interested in contributing
>>>>>>>>>>> to Kalzium.
>>>>>>>>>>>
>>>>>>>>>>> Can you give me some links on where to start and also how to
>>>>>>>>>>> build Kalzium on my Linux MINT? What are the dependencies and libraries
>>>>>>>>>>> required?
>>>>>>>>>>>
>>>>>>>>>>> Thank-you.
>>>>>>>>>>>
>>>>>>>>>>> With Regards,
>>>>>>>>>>> Shalin Shah
>>>>>>>>>>>
>>>>>>>>>>> _______________________________________________
>>>>>>>>>>> kde-edu mailing list
>>>>>>>>>>> kde-edu at mail.kde.org
>>>>>>>>>>> https://mail.kde.org/mailman/listinfo/kde-edu
>>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>> _______________________________________________
>>>>>>>>>> kde-edu mailing list
>>>>>>>>>> kde-edu at mail.kde.org
>>>>>>>>>> https://mail.kde.org/mailman/listinfo/kde-edu
>>>>>>>>>>
>>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>> _______________________________________________
>>>>>>>> kde-edu mailing list
>>>>>>>> kde-edu at mail.kde.org
>>>>>>>> https://mail.kde.org/mailman/listinfo/kde-edu
>>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>> _______________________________________________
>>>>>>> kde-edu mailing list
>>>>>>> kde-edu at mail.kde.org
>>>>>>> https://mail.kde.org/mailman/listinfo/kde-edu
>>>>>>>
>>>>>>
>>>>>>
>>>>>> _______________________________________________
>>>>>> kde-edu mailing list
>>>>>> kde-edu at mail.kde.org
>>>>>> https://mail.kde.org/mailman/listinfo/kde-edu
>>>>>>
>>>>>
>>>>>
>>>>> _______________________________________________
>>>>> kde-edu mailing list
>>>>> kde-edu at mail.kde.org
>>>>> https://mail.kde.org/mailman/listinfo/kde-edu
>>>>>
>>>>
>>>>
>>>> _______________________________________________
>>>> kde-edu mailing list
>>>> kde-edu at mail.kde.org
>>>> https://mail.kde.org/mailman/listinfo/kde-edu
>>>>
>>>
>>>
>>> _______________________________________________
>>> kde-edu mailing list
>>> kde-edu at mail.kde.org
>>> https://mail.kde.org/mailman/listinfo/kde-edu
>>>
>>
>
>
> _______________________________________________
> kde-edu mailing list
> kde-edu at mail.kde.org
> https://mail.kde.org/mailman/listinfo/kde-edu
>

[1] https://techbase.kde.org/Policies/KDE4_Library_Documentation_Policy

-- 
Regards,
Samikshan Bairagya,
KDE India | Red Hat
http://samxan.wordpress.com
(samikshan on Freenode IRC)