mastodon.world is one of the many independent Mastodon servers you can use to participate in the fediverse.
Generic Mastodon server for anyone to use.

Server stats:

8.1K
active users

#doxygen

0 posts0 participants0 posts today

I'm working on a project which includes files written in both C and #Lisp; I'd like to have a common documentation generator for the whole project, to generate integrated documentation.

Has anyone made #Doxygen work with Lisp? Are there any recommendations for a documentation generator which can work for both (and also Markdown, which is what my specification docs are written in?

Having to deprecate a part of #poser's API for the first time, I added support for the #deprecated attribute supported by #GCC and #clang and then found #Doxygen couldn't automatically use it.

I didn't want to document deprecation *twice*, so I came up with a little hackery, see screenshots. 🙈

It's not perfect, requiring to type the message in plain text as a macro argument forbids the usage of a comma 😉 But hey, it works!

zirias.github.io/poser/api/lat

TAB vs SPACE in C code ....

They taught me to use tabs 20 years ago, so I stayed with it in private projects.
Having one char for indentation feels more correct for me too.

But #VSCode fails to interpret #doxygen comments correctly if TABs
are involved. Doxygen output is fine, but my beloved on-mouse-over help is not.

So what?
Ignore SPACE-trends, convert doxygen-comments to spaces only or convert all to spaces (including some fun with GIT)?

I don't know what i want. 😫

Правильный путь создания python-библиотеки: от создания до публикации

Привет, Хабр! Стоит ли говорить, что Python ОЧЕНЬ и ОЧЕНЬ популярный язык программирования, местами даже догоняя JavaScript. Python в мире программирования — это эсперанто, легкий язык созданный для всех, но его владельцам не мешало бы помыться. В мире программирования создание собственных библиотек — это не просто возможность пополнения своего портфолио или способ структурировать код, а настоящий акт творческого самовыражения (и иногда велосипедостроения). Каждый разработчик иногда использовал в нескольких своих проектах однообразный код, который приходилось каждый раз перемещать. Да и хотя бы как упаковать свои идеи и знания в удобный и доступный формат, которым можно будет поделиться с сообществом. Если вы ловили себя на мысли: «А почему мне бы не создать свою полноценную библиотеку?», то я рекомендую прочитать вам мою статью. Эту статью вы можете использовать как шпаргалку для создания своих python-библиотек. Я полностью расскажу все этапы создания библиотеки: документация, тестирование, архитектура, публикация и управление зависимостями Некоторые из вас могут подумать что мы изобретаем велосипед. А я в ответ скажу — сможете ли вы прямо сейчас, без подсказок, только по памяти, нарисовать велосипед без ошибок?

habr.com/ru/companies/timeweb/

ХабрПравильный путь создания python-библиотеки: от создания до публикацииПривет, Хабр! Стоит ли говорить, что Python ОЧЕНЬ и ОЧЕНЬ популярный язык программирования, местами даже догоняя JavaScript. Python в мире программирования — это эсперанто, легкий язык созданный для...

Создаем свою простую (C++) библиотеку с документацией, CMake и блекджеком

В мире программирования создание собственных библиотек — это не просто возможность пополнения своего портфолио или способ структурировать код, а настоящий акт творческого самовыражения (и иногда велосипедостроения). Каждый разработчик иногда использовал в нескольких своих проектах однообразный код, который приходилось каждый раз перемещать. Да и хотя бы как упаковать свои идеи и знания в удобный и доступный формат, которым можно будет поделиться с сообществом. Если вы ловили себя на мысли: ‭«А почему мне бы не создать свою полноценную библиотеку?‭», то я рекомендую прочитать вам мою статью. Эту статью вы можете использовать как шпаргалку для создания проектов, и не только библиотек. Некоторые из вас могут подумать что мы изобретаем велосипед. А я в ответ скажу — сможете ли вы прямо сейчас, без подсказок, только по памяти, нарисовать велосипед без ошибок?

habr.com/ru/companies/timeweb/

#C++ #doxygen #open_source #github #библиотека #туториал #создание_библиотеки #создание_проекта #cmake

ХабрСоздаем свою простую (C++) библиотеку с документацией, CMake и блекджекомВ мире программирования создание собственных библиотек — это не просто возможность пополнения своего портфолио или способ структурировать код, а настоящий акт творческого самовыражения (и иногда...

@debacle @alienghic I wish there was a package for those projects that use #Doxygen or those that #Qt's #QDoc.
Some projects such as KDE use docbooks, there's a rudamentary mode for them:
elpa.gnu.org/packages/docbook.

With doxygen , Qt or Pythons API doc doc the documentation often doesn't really look like a manual like in Info mode I think there
should be a separate mode for such to view them or something that makes them easier to view in a single page per object.

elpa.gnu.orgGNU ELPA - docbook

The s390x open source team at IBM confirms the latest versions of various software packages run well on #Linux on #IBMZ & #LinuxONE

In June 2024 validation was maintained for over 30 projects, including: #CockroachDB #doxygen & #HashiCorp's #Terraform

Also, the AI/ML team at #IBM did initial work focused on s390x compatibility for Mage AI & the Triton Inference Server received compatibility fixes for big endian platforms.

Full report at: community.ibm.com/community/us

community.ibm.com · Linux on IBM Z and LinuxONE Open Source Software Report: June 2024