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

[Michael Gottesman]

On IRC Sean said go. Committed in r171799.

On Jan 7, 2013, at 2:23 PM, Michael Gottesman <mgottesman at apple.com> wrote:

> Ok done. So I assuming this means go?
> 
> On Jan 7, 2013, at 2:05 PM, Sean Silva <silvas at purdue.edu> wrote:
> 
>> 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
>>>>>>>>>>>> 
>>>>>>>>>>> 
>>>>>>>>>> 
>>>>>>>>> 
>>>>>>>> 
>>>>>>> 
>>>>>> 
>>>>> 
>>>> 
>>> 
>