docs: Make crypto_core.h appear on doxygen.

.github/scripts/cmake-linux

@@ -33,5 +33,6 @@ cmake -B_build -H. -GNinja \
 cmake --build _build --parallel "$NPROC" --target install -- -k 0
 
 cd _build # pushd
-ctest -j50 --output-on-failure --rerun-failed --repeat until-pass:6
+ctest -j50 --output-on-failure --rerun-failed --repeat until-pass:6 ||
+  ctest -j50 --output-on-failure --rerun-failed --repeat until-pass:6
 cd - # popd

.github/scripts/cmake-osx

@@ -31,5 +31,6 @@ cmake -B_build -H. \
 
 cd _build # pushd
 make "-j$NPROC" -k install
-ctest -j50 --output-on-failure --rerun-failed --repeat until-pass:6
+ctest -j50 --output-on-failure --rerun-failed --repeat until-pass:6 ||
+  ctest -j50 --output-on-failure --rerun-failed --repeat until-pass:6
 cd - # popd

.github/settings.yml

@@ -42,6 +42,7 @@ branches:
           - "docker-bootstrap-node-websocket"
           - "docker-toxcore-js"
           - "mypy"
+          - "netlify/c-toxcore/deploy-preview"
           - "sonar-scan"
 
 # Labels specific to c-toxcore.

.doxygen.conf → docs/Doxyfile

@@ -2236,7 +2236,7 @@ INCLUDE_FILE_PATTERNS  =
 # recursively expanded use the := operator instead of the = operator.
 # This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
 
-PREDEFINED             = DOXYGEN_SKIP
+PREDEFINED             = DOXYGEN_IGNORE
 
 # If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then this
 # tag can be used to specify a list of macro names that should be expanded. The

netlify.toml

@@ -5,6 +5,6 @@ command = """\
   else \
     git clone --depth=1 https://github.com/jothepro/doxygen-awesome-css.git;
   fi && \
-  doxygen .doxygen.conf \
+  doxygen docs/Doxyfile \
   """
 publish = "_docs/html"

other/docker/doxygen/Dockerfile

@@ -9,9 +9,9 @@ RUN apk add --no-cache doxygen git graphviz \
  && git clone --depth=1 https://github.com/jothepro/doxygen-awesome-css.git /work/doxygen-awesome-css
 WORKDIR /work
 COPY . /work/
-RUN cat .doxygen.conf > doxygen.conf \
- && echo "WARN_AS_ERROR = YES" >> doxygen.conf \
- && doxygen doxygen.conf
+RUN cat docs/Doxyfile > Doxyfile \
+ && echo "WARN_AS_ERROR = YES" >> Doxyfile \
+ && doxygen Doxyfile
 
 FROM nginx:alpine
 COPY --from=build /work/_docs/html/ /usr/share/nginx/html/

toxav/toxav.h

@@ -3,7 +3,7 @@
  * Copyright © 2013-2015 Tox project.
  */
 
-/** @file toxav.h
+/** @file
  * @brief Public audio/video API for Tox clients.
  *
  * This API can handle multiple calls. Each call has its state, in very rare
@@ -832,7 +832,7 @@ bool toxav_groupchat_av_enabled(Tox *tox, uint32_t groupnumber);
 #endif
 
 //!TOKSTYLE-
-#ifdef DOXYGEN_IGNORE
+#ifndef DOXYGEN_IGNORE
 
 typedef Toxav_Err_Call TOXAV_ERR_CALL;
 typedef Toxav_Err_New TOXAV_ERR_NEW;

toxcore/crypto_core.c

@@ -182,11 +182,6 @@ bool public_key_valid(const uint8_t *public_key)
     return 1;
 }
 
-/**
- * Fast encrypt/decrypt operations. Use if this is not a one-time communication.
- * encrypt_precompute does the shared-key generation once so it does not have
- * to be performed on every encrypt/decrypt.
- */
 int32_t encrypt_precompute(const uint8_t *public_key, const uint8_t *secret_key,
                            uint8_t *shared_key)
 {
@@ -320,10 +315,6 @@ int32_t decrypt_data(const uint8_t *public_key, const uint8_t *secret_key, const
     return ret;
 }
 
-/**
- * Increment the given nonce by 1 in big endian (rightmost byte incremented
- * first).
- */
 void increment_nonce(uint8_t *nonce)
 {
     /* TODO(irungentoo): use `increment_nonce_number(nonce, 1)` or
@@ -343,10 +334,6 @@ void increment_nonce(uint8_t *nonce)
     }
 }
 
-/**
- * Increment the given nonce by a given number. The number should be in host
- * byte order.
- */
 void increment_nonce_number(uint8_t *nonce, uint32_t increment)
 {
     /* NOTE don't use breaks inside this loop
@@ -369,17 +356,11 @@ void increment_nonce_number(uint8_t *nonce, uint32_t increment)
     }
 }
 
-/**
- * Fill the given nonce with random bytes.
- */
 void random_nonce(uint8_t *nonce)
 {
     random_bytes(nonce, crypto_box_NONCEBYTES);
 }
 
-/**
- * Fill a key CRYPTO_SYMMETRIC_KEY_SIZE big with random bytes.
- */
 void new_symmetric_key(uint8_t *key)
 {
     random_bytes(key, CRYPTO_SYMMETRIC_KEY_SIZE);