[cfe-commits] [PATCH] Convert Block-ABI-Apple.txt => Block-ABI-Apple.rst

[Sean Silva]

I filed <http://llvm.org/bugs/show_bug.cgi?id=14714> a while back due
to the issue of URL permanence. I have no clue what the server side
setup is nor where to go and fix it.

Also, what you may have been thinking of was that we copy stray HTML
files (pending doing something about LibASTMatchersReference.html). I
added a similar hack for the lone .txt file in r171795 and the URL is
back now <http://clang.llvm.org/docs/Block-ABI-Apple.txt>.

I think the rst document can be committed (leaving the old file in
place, but with its contents replaced by a "poor man's redirect"
saying "this content has moved to ..." so that the content is not
duplicated).

-- Sean Silva

On Mon, Jan 7, 2013 at 2:22 PM, Jordan Rose <jordan_rose at apple.com> wrote:
> The whole point is to get the old URL to do something useful -- either a manual redirect or an automatic redirect. If you can make that happen, we're good. :-)
>
> Jordan
>
>
> On Jan 7, 2013, at 11:21 , Michael Gottesman <mgottesman at apple.com> wrote:
>
>> How about I create a separate rst file that just consists of said text file i.e. using the ``raw`` directive. Maybe call it Block-ABI-Apple-Text.rst?
>>
>> Michael
>>
>> On Jan 7, 2013, at 11:13 AM, Jordan Rose <jordan_rose at apple.com> wrote:
>>
>>> It would be if Sphinx copied over stray text files, but would not be if it does not. OTOH I guess it's already been broken since we first switched to Sphinx, so maybe it shouldn't block you, but I still think this is important. I was hoping Sean would have a better appropriate solution.
>>>
>>>
>>> On Jan 7, 2013, at 11:10 , Michael Gottesman <mgottesman at apple.com> wrote:
>>>
>>>> So you did not answer my question. Is that an appropriate solution to your objection?
>>>>
>>>> = )
>>>>
>>>> Michael
>>>>
>>>> On Jan 7, 2013, at 10:37 AM, Jordan Rose <jordan_rose at apple.com> wrote:
>>>>
>>>>> Grr. Sean, does Sphinx not copy over stray text files? That's sort of a problem for URL permanence.
>>>>>
>>>>> (I feel like this already came up once; am I wrong about that?)
>>>>>
>>>>> Jordan
>>>>>
>>>>>
>>>>> On Jan 7, 2013, at 10:12 , Michael Gottesman <mgottesman at apple.com> wrote:
>>>>>
>>>>>> How does this sound:
>>>>>>
>>>>>> ``*NOTE* This document has moved to http://clang.llvm.org/docs/Block-ABI-Apple.html.''
>>>>>>
>>>>>> On another note, it seems that http://clang.llvm.org/docs/Block-ABI-Apple.txt does not exist.
>>>>>>
>>>>>> On Jan 7, 2013, at 10:05 AM, Michael Gottesman <mgottesman at apple.com> wrote:
>>>>>>
>>>>>>> Ok.
>>>>>>>
>>>>>>> On Jan 7, 2013, at 9:43 AM, Jordan Rose <jordan_rose at apple.com> wrote:
>>>>>>>
>>>>>>>> I don't think we have any mechanism set up for automated redirects, but a simple note in the .txt file saying "This document has moved to ___" would probably be fine (i.e. rather than deleting it). Obviously a redirect would be better but I don't know how to do that.
>>>>>>>>
>>>>>>>> Jordan
>>>>>>>>
>>>>>>>>
>>>>>>>> On Jan 7, 2013, at 9:41 , Michael Gottesman <mgottesman at apple.com> wrote:
>>>>>>>>
>>>>>>>>> What do you mean by this specifically (i.e. what would it entail in terms of this patch).
>>>>>>>>>
>>>>>>>>> Michael
>>>>>>>>>
>>>>>>>>> On Jan 7, 2013, at 9:20 AM, Jordan Rose <jordan_rose at apple.com> wrote:
>>>>>>>>>
>>>>>>>>>> Since this is a spec, we should probably keep the old URL live, even if it just points to the generated .html.
>>>>>>>>>>
>>>>>>>>>> Jordan
>>>>>>>>>>
>>>>>>>>>>
>>>>>>>>>> On Jan 6, 2013, at 20:39 , Sean Silva <silvas at purdue.edu> wrote:
>>>>>>>>>>
>>>>>>>>>>> LGTM
>>>>>>>>>>>
>>>>>>>>>>> -- Sean Silva
>>>>>>>>>>>
>>>>>>>>>>> On Sun, Jan 6, 2013 at 11:22 PM, Michael Gottesman <mgottesman at apple.com> wrote:
>>>>>>>>>>>> Subject says it all. Please review:
>>>>>>>>>>>>
>>>>>>>>>>>>
>>>>>>>>>>>>
>>>>>>>>>>>>
>>>>>>>>>>>> Michael
>>>>>>>>>>>>
>>>>>>>>>>>> _______________________________________________
>>>>>>>>>>>> cfe-commits mailing list
>>>>>>>>>>>> cfe-commits at cs.uiuc.edu
>>>>>>>>>>>> http://lists.cs.uiuc.edu/mailman/listinfo/cfe-commits
>>>>>>>>>>>>
>>>>>>>>>>> _______________________________________________
>>>>>>>>>>> cfe-commits mailing list
>>>>>>>>>>> cfe-commits at cs.uiuc.edu
>>>>>>>>>>> http://lists.cs.uiuc.edu/mailman/listinfo/cfe-commits
>>>>>>>>>>
>>>>>>>>>
>>>>>>>>
>>>>>>>
>>>>>>
>>>>>
>>>>
>>>
>>
>