manual: fix listing refs for mkdocs

This commit is contained in:
Milanka Ringwald 2015-06-24 17:21:05 +02:00
parent 4c719da614
commit cae650303c
6 changed files with 21 additions and 13 deletions

View File

@ -14,7 +14,8 @@ all:
cp btstack_gettingstarted.tex latex cp btstack_gettingstarted.tex latex
cd latex && pdflatex btstack_gettingstarted.tex && pdflatex btstack_gettingstarted.tex cd latex && pdflatex btstack_gettingstarted.tex && pdflatex btstack_gettingstarted.tex
mv latex/btstack_gettingstarted.pdf btstack.pdf mv latex/btstack_gettingstarted.pdf btstack.pdf
rm -rf latex docs_final rm -rf latex

View File

@ -75,7 +75,7 @@ by RFCOMM:
Possible errors: an L2CAP error, out of memory. Possible errors: an L2CAP error, out of memory.
- RFCOMM_EVENT_CREDITS - The application can resume sending when - RFCOMM_EVENT_CREDITS - The application can resume sending when
this even is received. See Section on [RFCOMM credit-based flow-control]{protocols/#sec:flowControlProtocols} this even is received. See Section on [RFCOMM credit-based flow-control](../protocols/#sec:flowControlProtocols)
for more. for more.
- RFCOMM_EVENT_SERVICE_REGISTERED - Status not equal zero indicates - RFCOMM_EVENT_SERVICE_REGISTERED - Status not equal zero indicates

View File

@ -66,13 +66,20 @@ def process_tables(temp_file, dest_file):
return return
# def process_listings(temp_file, dest_file): def process_listings(temp_file, dest_file):
# with open(dest_file, 'w') as mdout: with open(dest_file, 'w') as mdout:
# with open(temp_file, 'r') as mdin: with open(temp_file, 'r') as mdin:
# for line in mdin: for line in mdin:
# mdout.write(line) listing_start = re.match('.*{#(lst:.*)\s+.c\s+.*',line)
# fcopy(dest_file, temp_file) listing_end = re.match('\s*~~~~\s*\n',line)
# return if listing_start:
insert_anchor(mdout, listing_start.group(1))
elif listing_end:
mdout.write("\n")
else:
mdout.write(line)
fcopy(dest_file, temp_file)
return
@ -92,7 +99,7 @@ def main(argv):
process_sections(temp_file, dest_file) process_sections(temp_file, dest_file)
process_figures(temp_file, dest_file) process_figures(temp_file, dest_file)
process_tables(temp_file, dest_file) process_tables(temp_file, dest_file)
# process_listings(temp_file, dest_file) process_listings(temp_file, dest_file)
if __name__ == "__main__": if __name__ == "__main__":

View File

@ -236,7 +236,7 @@ static void packet_handler (uint8_t packet_type, uint8_t *packet, uint16_t size)
} }
/* @text For more details on discovering remote devices, please see /* @text For more details on discovering remote devices, please see
* Section on [GAP](profiles/#sec:GAPdiscoverRemoteDevices). * Section on [GAP](../profiles/#sec:GAPdiscoverRemoteDevices).
*/ */

View File

@ -98,7 +98,7 @@ static int service_index = 0;
* packet handlers, as shown in Listing GATTClientSetup. * packet handlers, as shown in Listing GATTClientSetup.
* Additionally, the security manager can be setup, if signed writes, or * Additionally, the security manager can be setup, if signed writes, or
* encrypted, or authenticated connection are required, to access the * encrypted, or authenticated connection are required, to access the
* characteristics, as explained in Section on [SMP](protocols/#sec:smpProtocols). * characteristics, as explained in Section on [SMP](../protocols/#sec:smpProtocols).
*/ */
/* LISTING_START(GATTClientSetup): Setting up GATT client */ /* LISTING_START(GATTClientSetup): Setting up GATT client */

View File

@ -315,7 +315,7 @@ char * get_string_from_data_element(uint8_t * element){
/* @section SDP parser callback /* @section SDP parser callback
* *
* @text The SDP parsers retrieves the BNEP PAN UUID as explained in * @text The SDP parsers retrieves the BNEP PAN UUID as explained in
* Section [on SDP BNEP Query example](examples/#sec:sdpbnepqueryExample}. * Section [on SDP BNEP Query example](#sec:sdpbnepqueryExample}.
*/ */
static void handle_sdp_client_query_result(sdp_query_event_t *event) static void handle_sdp_client_query_result(sdp_query_event_t *event)
{ {