[docs] [issue24984] document AF_BLUETOOTH socket address formats

Tim Tisdall report at bugs.python.org
Wed Sep 2 18:06:50 CEST 2015

New submission from Tim Tisdall:

Currently https://docs.python.org/3.6/library/socket.html#socket-families only says "Certain other address families (AF_BLUETOOTH, AF_PACKET, AF_CAN) support specific representations." and there's a comment in the docs saying "document them!"...  So, I'm documenting the AF_BLUETOOTH.

I'm not sure about which versions this should be added to except for 3.6 so I'm listing the pertinent issues when changes were made: 

issue929192 seems to be where the current address format was added for L2CAP, RFCOMM, and SCO

issue1432399 seems to be where HCI was added

issue5510 seems to be where the alternate address format for HCI was added for NetBSD and DragonFlyBSD

It seems SCO used to accept a regular string but at 23ab586c427a it was changed to use a `bytes`...  I'm not sure the issue behind that.

This is my first contribution to CPython so I figured a patch to the docs would be easiest.  Please let me know if I'm doing anything wrong!

assignee: docs at python
components: Documentation
files: bluetooth_socket_docs.patch
keywords: patch
messages: 249554
nosy: Tim.Tisdall, docs at python
priority: normal
severity: normal
status: open
title: document AF_BLUETOOTH socket address formats
Added file: http://bugs.python.org/file40320/bluetooth_socket_docs.patch

Python tracker <report at bugs.python.org>

More information about the docs mailing list