From: Daniel Salzman Date: Tue, 18 Dec 2018 20:27:44 +0000 (+0100) Subject: src: remove Doxygen header if not API X-Git-Tag: v2.8.0~137^2 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=2b6f5912e9bab8b72f00f0ee8faba4cd397d0a96;p=thirdparty%2Fknot-dns.git src: remove Doxygen header if not API --- diff --git a/src/knot/nameserver/chaos.h b/src/knot/nameserver/chaos.h index e30ce2bea9..f875abed27 100644 --- a/src/knot/nameserver/chaos.h +++ b/src/knot/nameserver/chaos.h @@ -1,4 +1,4 @@ -/* Copyright (C) 2015 CZ.NIC, z.s.p.o. +/* Copyright (C) 2018 CZ.NIC, z.s.p.o. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -13,14 +13,6 @@ You should have received a copy of the GNU General Public License along with this program. If not, see . */ -/*! - * \file - * - * \brief Chaos class processing. - * - * \addtogroup query_processing - * @{ - */ #pragma once @@ -30,5 +22,3 @@ * \brief Create a response for a given query in the CHAOS class. */ int knot_chaos_answer(knot_pkt_t *pkt); - -/*! @} */ diff --git a/src/knot/updates/acl.h b/src/knot/updates/acl.h index bf193429f0..d42a97d6fb 100644 --- a/src/knot/updates/acl.h +++ b/src/knot/updates/acl.h @@ -13,14 +13,6 @@ You should have received a copy of the GNU General Public License along with this program. If not, see . */ -/*! - * \file - * - * Access control list. - * - * \addtogroup server - * @{ - */ #pragma once @@ -71,5 +63,3 @@ typedef enum { bool acl_allowed(conf_t *conf, conf_val_t *acl, acl_action_t action, const struct sockaddr_storage *addr, knot_tsig_key_t *tsig, const knot_dname_t *zone_name, knot_pkt_t *query); - -/*! @} */ diff --git a/src/knot/updates/ddns.h b/src/knot/updates/ddns.h index 68f3867c8f..1d792189f2 100644 --- a/src/knot/updates/ddns.h +++ b/src/knot/updates/ddns.h @@ -1,4 +1,4 @@ -/* Copyright (C) 2017 CZ.NIC, z.s.p.o. +/* Copyright (C) 2018 CZ.NIC, z.s.p.o. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -13,14 +13,6 @@ You should have received a copy of the GNU General Public License along with this program. If not, see . */ -/*! - * \file - * - * \brief Dynamic updates processing. - * - * \addtogroup ddns - * @{ - */ #pragma once @@ -53,5 +45,3 @@ int ddns_process_prereqs(const knot_pkt_t *query, zone_update_t *update, */ int ddns_process_update(const zone_t *zone, const knot_pkt_t *query, zone_update_t *update, uint16_t *rcode); - -/*! @} */ diff --git a/src/knot/zone/contents.h b/src/knot/zone/contents.h index 22c25951ca..2c8e2c80eb 100644 --- a/src/knot/zone/contents.h +++ b/src/knot/zone/contents.h @@ -13,14 +13,6 @@ You should have received a copy of the GNU General Public License along with this program. If not, see . */ -/*! - * \file - * - * Zone contents structure and API for manipulating it. - * - * \addtogroup zone - * @{ - */ #pragma once @@ -268,5 +260,3 @@ size_t zone_contents_measure_size(zone_contents_t *zone); * \return Maximal TTL. */ uint32_t zone_contents_max_ttl(zone_contents_t *zone); - -/*! @} */ diff --git a/src/knot/zone/zone-dump.h b/src/knot/zone/zone-dump.h index 5f92042a90..9734740d66 100644 --- a/src/knot/zone/zone-dump.h +++ b/src/knot/zone/zone-dump.h @@ -1,4 +1,4 @@ -/* Copyright (C) 2016 CZ.NIC, z.s.p.o. +/* Copyright (C) 2018 CZ.NIC, z.s.p.o. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -13,14 +13,6 @@ You should have received a copy of the GNU General Public License along with this program. If not, see . */ -/*! - * \file - * - * \brief Zone text dump facility. - * - * \addtogroup zone - * @{ - */ #pragma once @@ -37,5 +29,3 @@ * \retval < 0 if error. */ int zone_dump_text(zone_contents_t *zone, FILE *file, bool comments); - -/*! @} */ diff --git a/src/utils/common/exec.h b/src/utils/common/exec.h index 57758abd3a..2940be485c 100644 --- a/src/utils/common/exec.h +++ b/src/utils/common/exec.h @@ -1,4 +1,4 @@ -/* Copyright (C) 2016 CZ.NIC, z.s.p.o. +/* Copyright (C) 2018 CZ.NIC, z.s.p.o. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -13,14 +13,6 @@ You should have received a copy of the GNU General Public License along with this program. If not, see . */ -/*! - * \file - * - * \brief Common executives for utils. - * - * \addtogroup knot_utils - * @{ - */ #pragma once @@ -93,5 +85,3 @@ void print_packet(const knot_pkt_t *packet, const time_t exec_time, const bool incoming, const style_t *style); - -/*! @} */ diff --git a/src/utils/common/hex.h b/src/utils/common/hex.h index c0d2113123..fd97f92e45 100644 --- a/src/utils/common/hex.h +++ b/src/utils/common/hex.h @@ -1,4 +1,4 @@ -/* Copyright (C) 2017 CZ.NIC, z.s.p.o. +/* Copyright (C) 2018 CZ.NIC, z.s.p.o. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -14,15 +14,6 @@ along with this program. If not, see . */ -/*! - * \file - * - * \brief Coversion between HEX strings and bytes. - * - * \addtogroup knot_utils - * @{ - */ - #pragma once #include @@ -38,5 +29,3 @@ * \return Error code, KNOT_EOK if successful. */ int hex_decode(const char *input, uint8_t **output, size_t *output_size); - -/*! @} */ diff --git a/src/utils/common/lookup.h b/src/utils/common/lookup.h index cea8a486d6..3f43ab6262 100644 --- a/src/utils/common/lookup.h +++ b/src/utils/common/lookup.h @@ -1,4 +1,4 @@ -/* Copyright (C) 2016 CZ.NIC, z.s.p.o. +/* Copyright (C) 2018 CZ.NIC, z.s.p.o. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -13,14 +13,6 @@ You should have received a copy of the GNU General Public License along with this program. If not, see . */ -/*! - * \file - * - * \brief Lookup container for textual strings. - * - * \addtogroup knot_utils - * @{ - */ #pragma once @@ -118,5 +110,3 @@ void lookup_list(lookup_t *lookup); */ void lookup_complete(lookup_t *lookup, const char *str, size_t str_len, EditLine *el, bool add_space); - -/*! @} */ diff --git a/src/utils/common/msg.h b/src/utils/common/msg.h index 23b4164f02..02eedcc37c 100644 --- a/src/utils/common/msg.h +++ b/src/utils/common/msg.h @@ -1,4 +1,4 @@ -/* Copyright (C) 2011 CZ.NIC, z.s.p.o. +/* Copyright (C) 2018 CZ.NIC, z.s.p.o. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -13,16 +13,6 @@ You should have received a copy of the GNU General Public License along with this program. If not, see . */ -/*! - * \file msg.h - * - * \author Daniel Salzman - * - * \brief Simple output formatting framework. - * - * \addtogroup knot_utils - * @{ - */ #pragma once @@ -46,5 +36,3 @@ int msg_debug(const char *fmt, ...); /*! \brief Debug message for null input. */ #define DBG_NULL DBG("%s: null parameter\n", __func__) - -/*! @} */ diff --git a/src/utils/common/netio.h b/src/utils/common/netio.h index b54507ebe1..4394ce42a5 100644 --- a/src/utils/common/netio.h +++ b/src/utils/common/netio.h @@ -1,4 +1,4 @@ -/* Copyright (C) 2017 CZ.NIC, z.s.p.o. +/* Copyright (C) 2018 CZ.NIC, z.s.p.o. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -13,14 +13,6 @@ You should have received a copy of the GNU General Public License along with this program. If not, see . */ -/*! - * \file - * - * \brief Networking abstraction for utilities. - * - * \addtogroup knot_utils - * @{ - */ #pragma once @@ -225,5 +217,3 @@ void net_close(net_t *net); * \param net Connection parameters. */ void net_clean(net_t *net); - -/*! @} */ diff --git a/src/utils/common/params.h b/src/utils/common/params.h index c68ce6076e..fa6332538c 100644 --- a/src/utils/common/params.h +++ b/src/utils/common/params.h @@ -1,4 +1,4 @@ -/* Copyright (C) 2017 CZ.NIC, z.s.p.o. +/* Copyright (C) 2018 CZ.NIC, z.s.p.o. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -13,14 +13,6 @@ You should have received a copy of the GNU General Public License along with this program. If not, see . */ -/*! - * \file - * - * \brief Common utils parameters processing. - * - * \addtogroup knot_utils - * @{ - */ #pragma once @@ -166,5 +158,3 @@ int params_parse_type(const char *value, uint16_t *rtype, int64_t *serial, int params_parse_server(const char *value, list_t *servers, const char *def_port); int params_parse_wait(const char *value, int32_t *dst); - -/*! @} */ diff --git a/src/utils/common/resolv.h b/src/utils/common/resolv.h index 98b5db58c6..fb751d1310 100644 --- a/src/utils/common/resolv.h +++ b/src/utils/common/resolv.h @@ -1,4 +1,4 @@ -/* Copyright (C) 2011 CZ.NIC, z.s.p.o. +/* Copyright (C) 2018 CZ.NIC, z.s.p.o. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -13,16 +13,6 @@ You should have received a copy of the GNU General Public License along with this program. If not, see . */ -/*! - * \file resolv.h - * - * \author Daniel Salzman - * - * \brief resolv.conf processing. - * - * \addtogroup knot_utils - * @{ - */ #pragma once @@ -32,5 +22,3 @@ srv_info_t* parse_nameserver(const char *str, const char *def_port); void get_nameservers(list_t *servers, const char *def_port); - -/*! @} */ diff --git a/src/utils/common/token.h b/src/utils/common/token.h index 90d3eab81a..fab4ea1691 100644 --- a/src/utils/common/token.h +++ b/src/utils/common/token.h @@ -1,4 +1,4 @@ -/* Copyright (C) 2011 CZ.NIC, z.s.p.o. +/* Copyright (C) 2018 CZ.NIC, z.s.p.o. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -13,16 +13,6 @@ You should have received a copy of the GNU General Public License along with this program. If not, see . */ -/*! - * \file token.h - * - * \author Marek Vavrusa - * - * \brief String tokenizer and simple scanner. - * - * \addtogroup knot_utils - * @{ - */ #pragma once @@ -73,5 +63,3 @@ int tok_find(const char *lp, const char **tbl); * \return ptr to next non-blank character. */ const char *tok_skipspace(const char *lp); - -/*! @} */