| 1 | /* Copyright (C) 2019-2026 Free Software Foundation, Inc. |
| 2 | Contributed by David Malcolm <dmalcolm@redhat.com>. |
| 3 | |
| 4 | This file is part of GCC. |
| 5 | |
| 6 | GCC is free software; you can redistribute it and/or modify it under |
| 7 | the terms of the GNU General Public License as published by the Free |
| 8 | Software Foundation; either version 3, or (at your option) any later |
| 9 | version. |
| 10 | |
| 11 | GCC is distributed in the hope that it will be useful, but WITHOUT ANY |
| 12 | WARRANTY; without even the implied warranty of MERCHANTABILITY or |
| 13 | FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
| 14 | for more details. |
| 15 | |
| 16 | You should have received a copy of the GNU General Public License |
| 17 | along with GCC; see the file COPYING3. If not see |
| 18 | <http://www.gnu.org/licenses/>. */ |
| 19 | |
| 20 | #ifndef GCC_DIAGNOSTICS_URL_H |
| 21 | #define GCC_DIAGNOSTICS_URL_H |
| 22 | |
| 23 | /* Whether to add URLs to diagnostics: |
| 24 | - DIAGNOSTICS_URL_NO: never |
| 25 | - DIAGNOSTICS_URL_YES: always |
| 26 | - DIAGNOSTICS_URL_AUTO: depending on the output stream. */ |
| 27 | typedef enum |
| 28 | { |
| 29 | DIAGNOSTICS_URL_NO = 0, |
| 30 | DIAGNOSTICS_URL_YES = 1, |
| 31 | DIAGNOSTICS_URL_AUTO = 2 |
| 32 | } diagnostic_url_rule_t; |
| 33 | |
| 34 | /* Tells whether URLs should be emitted, and, if so, how to |
| 35 | terminate strings within the escape sequence. */ |
| 36 | enum diagnostic_url_format |
| 37 | { |
| 38 | /* No URLs shall be emitted. */ |
| 39 | URL_FORMAT_NONE, |
| 40 | |
| 41 | /* Use ST string termination. */ |
| 42 | URL_FORMAT_ST, |
| 43 | |
| 44 | /* Use BEL string termination. */ |
| 45 | URL_FORMAT_BEL |
| 46 | }; |
| 47 | |
| 48 | const diagnostic_url_format URL_FORMAT_DEFAULT = URL_FORMAT_BEL; |
| 49 | |
| 50 | extern diagnostic_url_format determine_url_format (diagnostic_url_rule_t); |
| 51 | |
| 52 | #endif /* ! GCC_DIAGNOSTICS_URL_H */ |
| 53 | |