From 836f3c828307f03563d181c526af6141b886111b Mon Sep 17 00:00:00 2001 From: "Ashwin V. Mohanan" <9155111+ashwinvis@users.noreply.github.com> Date: Thu, 16 Nov 2023 09:11:11 +0100 Subject: [PATCH] Format docstring for visibility parameter Without this change it is easy to get confused while reading the online docs. https://mastodonpy.readthedocs.io/en/stable/05_statuses.html#status-post --- mastodon/statuses.py | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/mastodon/statuses.py b/mastodon/statuses.py index fbe4fba..ba33298 100644 --- a/mastodon/statuses.py +++ b/mastodon/statuses.py @@ -199,15 +199,16 @@ class Mastodon(Internals): should be marked as sensitive, which hides it by default on the Mastodon web front-end. - The visibility parameter is a string value and accepts any of: - 'direct' - post will be visible only to mentioned users - 'private' - post will be visible only to followers - 'unlisted' - post will be public but not appear on the public timeline - 'public' - post will be public + The `visibility` parameter is a string value and accepts any of: + + * ``'direct'`` - post will be visible only to **mentioned users** + * ``'private'`` - post will be visible only to **followers** + * ``'unlisted'`` - post will be **public but not appear on the public timeline** + * ``'public'`` - post will be **public** - If not passed in, visibility defaults to match the current account's + If not passed in, `visibility` defaults to match the current account's default-privacy setting (starting with Mastodon version 1.6) or its - locked setting - private if the account is locked, public otherwise + locked setting - ``'private'`` if the account is locked, ``'public'`` otherwise (for Mastodon versions lower than 1.6). The `spoiler_text` parameter is a string to be shown as a warning before