ObjFW  History of src/exceptions/OFException.m of merge-in:4f84f6d

With TYPEDEF_HIDES_STRUCT set, Doxygen properly handles anonymous
structs and enums that are typedef'd. file: [5ced4219b2] check-in: [2fcf5a3052] user: js, branch: trunk, size: 7468 [annotate] [blame] [check-ins using] [diff]

Also rename of_rmutex_t -> OFPlainRecursiveMutex. file: [7a4b36018b] check-in: [dfd52d5220] user: js, branch: new-naming-convention, size: 7481 [annotate] [blame] [check-ins using] [diff]

It's possible OFMutex is not loaded yet. file: [9ab19e4a0d] check-in: [f02b51feba] user: js, branch: trunk, size: 7556 [annotate] [blame] [check-ins using] [diff]

errno is problematic for Amiga libraries and is also not thread-safe on
some systems, even though it should. file: [aa89efc62e] check-in: [5b37fbeb82] user: js, branch: trunk, size: 7593 [annotate] [blame] [check-ins using] [diff]

Just checking for _GNU_SOURCE is not enough, because musl still returns
int even with _GNU_SOURCE, despite the musl header explicitly checking
for _GNU_SOURCE. file: [3cf46d2139] check-in: [af603291de] user: js, branch: trunk, size: 7051 [annotate] [blame] [check-ins using] [diff]

This allows the runtime to only link against the parts it needs, without
pulling in unnecessary parts like thread spawning, TLS and conditions. file: [6ae5b59e9b] check-in: [5358e9ea6a] user: js, branch: trunk, size: 7063 [annotate] [blame] [check-ins using] [diff]

This removes the special casing for Itanium and makes compilation on
OpenBSD/SPARC64 work with clang. file: [7a9ee871b5] check-in: [879e69dd3d] user: js, branch: trunk, size: 6560 [annotate] [blame] [check-ins using] [diff]

Instead, explicitly declare them, as OF_ASSUME_NONNULL_{BEGIN,END} does
not apply to implicit return types. This means that after this commit,
all init methods have a nonnull return type, as they should have. file: [821a0dbd2f] check-in: [2f4e0df8be] user: js, branch: trunk, size: 7051 [annotate] [blame] [check-ins using] [diff]

This removes several initializers that omitted the errNo. Removing those
forces to think about whether there is a meaningful errNo to set instead
of just omitting it. file: [a4f5d8c32c] check-in: [4f36894ce7] user: js, branch: trunk, size: 7037 [annotate] [blame] [check-ins using] [diff]

Casts are now written like types in variable declarations. file: [0b126c90fd] check-in: [4af49a13c3] user: js, branch: trunk, size: 6941 [annotate] [blame] [check-ins using] [diff]

Forgot to add 2017, even though I already did quite some changes in
2017. file: [681ad6119e] check-in: [44f45c2e35] user: js, branch: trunk, size: 6626 [annotate] [blame] [check-ins using] [diff]

This singleton gives access to all things locale, including the ability
to get localized strings.

This also adds the OF_LOCALIZED() macro. Its first argument is an ID for
the string to be localized and its second argument is the fallback
string to be used if it cannot retrieve the localized string. Following
that are variable name / value pairs to be replaced in the localized
string.

Getting translated strings is not implemented yet: Instead, it always
uses the fallback string.

This also switches ofhttp to localized strings. file: [9a85916e30] check-in: [06bcb21fc7] user: js, branch: trunk, size: 6620 [annotate] [blame] [check-ins using] [diff]

(U)INT_FAST*_MAX is broken on Android, which makes (u)int_fast*_t
dangerous to use while it does not provide any real speed benefit. file: [79bfb21fe1] check-in: [d3158d091f] user: js, branch: trunk, size: 6500 [annotate] [blame] [check-ins using] [diff]

While at it, also update the mail address. file: [be5e01d81a] check-in: [cec0f072f8] user: js, branch: 0.8, size: 6556 [annotate] [blame] [check-ins using] [diff]

While at it, also update the mail address. file: [3ce36007c3] check-in: [2a27cf3000] user: js, branch: trunk, size: 6510 [annotate] [blame] [check-ins using] [diff]

Some systems declare strerror() and strerror_r() in string.h, others in
stdio.h. file: [ca1be9d395] check-in: [dddeff64f8] user: js, branch: trunk, size: 6552 [annotate] [blame] [check-ins using] [diff]

The old behaviour where the exception would access errno directly on
creation of the exception was very fragile. The two main problems with
it were that sometimes it would pick up an errno even though none had
been set and in other cases that when the exception was created errno
had already been overridden.

This also greatly increases errno handling on Win32, especially in
conjunction with sockets. It can still be improved further, though. file: [23bfa51fc4] check-in: [62e2de30b9] user: js, branch: trunk, size: 6477 [annotate] [blame] [check-ins using] [diff]

This means that OFObject.h imports macros.h now, making it unnecessary
to manually import macros.h in almost every file. And while at it, also
import autorelease.h in OFObject.h, so that this doesn't need to be
manually imported in almost every file as well. file: [fa215236ea] check-in: [13ee56edf3] user: js, branch: trunk, size: 5541 [annotate] [blame] [check-ins using] [diff]

Instead, just define _GNU_SOURCE when __GLIBC__ is defined. After all,
that's the only libc that doesn't work properly without any defines. file: [d55e878757] check-in: [17be12b6e5] user: js, branch: trunk, size: 5566 [annotate] [blame] [check-ins using] [diff]

Not using -std=gnu11 means _GNU_SOURCE does not get defined anymore,
therefore this commit also adds the required feature defines for glibc.

Additionally, this adds of_strdup in macros.h, as strdup is an
extension. file: [daa1364182] check-in: [2f5af58573] user: js, branch: trunk, size: 5587 [annotate] [blame] [check-ins using] [diff]

Does not work yet due to a GCC bug. I already found the bug and also
have a fix for it, but it needs to get upstreamed. file: [5e0042a4d3] check-in: [d7883de826] user: js, branch: trunk, size: 5587 [annotate] [blame] [check-ins using] [diff]

It seems to be defined when targeting 32-bit iOS, even though it does
not use zero-cost exceptions. file: [6a81d34ff8] check-in: [65d8a7c8ed] user: js, branch: trunk, size: 3917 [annotate] [blame] [check-ins using] [diff]

The offset is useless if the symbol is unknown, especially if it gets
large because the offset is relative to 0. file: [76191c1054] check-in: [353b3ba81d] user: js, branch: trunk, size: 3773 [annotate] [blame] [check-ins using] [diff]

This mostly removes the argument for the class in which the exception
occurred. As backtraces were recently added for all platforms, the
passed class does not give any extra information on where the exception
occurred anymore.

This also removes a few other arguments which were not too helpful. In
the past, the idea was to pass as many arguments as possible so that it
is easier to find the origin of the exception. However, as backtraces
are a much better way to find the origin, those are not useful anymore
and just make the exception more cumbersome to use. The rule is now to
only pass arguments that might help in recovering from the exception or
provide information that is otherwise not easily accessible. file: [ef6fdedc48] check-in: [3d16a30f41] user: js, branch: trunk, size: 2520 [annotate] [blame] [check-ins using] [diff]

With this, neither the buggy __builtin_return_address() nor the GNU-only
backtrace() are required for a backtrace. file: [59da75fa7e] check-in: [259f593244] user: js, branch: trunk, size: 2782 [annotate] [blame] [check-ins using] [diff]

The reason is that __builtin_frame_address(n) for n > 0 seems to just
crash on most platforms when -fomit-stack-pointer is specified, which
seems to be the default for many platforms on -O2. The documentation
says that __builtin_frame_address() should return NULL in case it can't
get the frame, but it seems to crash instead.

Therefore, this commit reverts to using backtrace() from execinfo.h, if
available. However, as __builtin_frame_address() seems to always work on
PPC (even with -fomit-frame-pointer) and seems to be the only way to get
a backtrace on the Wii, this is still used if backtrace() is unavailable
and __ppc__ defined. file: [fbd2e39b2b] check-in: [f2a8bdf254] user: js, branch: trunk, size: 3823 [annotate] [blame] [check-ins using] [diff]

Instead, __builtin_return_address() is used now. This makes backtraces
available on many platforms, it even works if dladdr is missing (it does
not show symbol names then, though). file: [18d7beaf46] check-in: [a889f21180] user: js, branch: trunk, size: 3039 [annotate] [blame] [check-ins using] [diff]

This was pretty pointless, as it's usually only used once. file: [5040476f6b] check-in: [d9ddc4d06e] user: js, branch: trunk, size: 1209 [annotate] [blame] [check-ins using] [diff]

This is safe as an "exception loop" can't happen, since if allocating
an exception fails, it throws an OFAllocFailedException which is
preallocated and can always be thrown.

So, the worst case would be that an autorelease of an exception fails,
triggering an OFOutOfMemoryException for which there is no memory,
resulting in an OFAllocFailedException to be thrown. file: [77fce54f87] check-in: [e1e7ffa903] user: js, branch: trunk, size: 1175 [annotate] [blame] [check-ins using] [diff]