there is some misunderstood parts

[3442853561]

In https://github.com/rust-lang-nursery/rustc-guide/blob/master/src/hir.md there is a sentence about "It is a desugared version of the abstract syntax tree"

I am not a native English speaker. So I just understand it in my mother language. When I tried to translate this sentence into Chinese which is my mother language. This looks like saying that HIR is a kind of abstract syntax tree.

If this sentence does not cause ambiguity in English, please close and ignore this issue.

[mark-i-m]

My understanding matches yours. The HIR is like an AST but with all the syntactic sugar removed.

[mark-i-m]

Is there a different way of phasing the sentence that would be easier to translate?

Also, thanks for opening this issue :) I think it is important for the guide to be accessible to non-native-English speakers.

[nagisa]

Definitely not all sugar is removed when lowering to HIR. What differs between the two is the purpose - AST must faithfully represent code, whereas HIR does not.

…

On Fri, Apr 20, 2018, 08:17 Who? Me?! ***@***.***> wrote: Is there a different way of phasing the sentence that would be easier to translate? Also, thanks for opening this issue :) I think it is important for the guide to be accessible to non-native-English speakers. — You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub <#116 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AApc0lMDmvV42x1wRRUKZjTr5WnZk5Moks5tqW9WgaJpZM4TcFAp> .

[mark-i-m]

@nagisa Thanks for the clarification :)

[Michael-F-Bryan]

This looks like saying that HIR is a kind of abstract syntax tree.

From what I've gathered when trying to use the compiler internals, you could say a hir::Crate is a more compiler-friendly representation of the AST where we've changed the precise way things are stored and desugared some bits to make analysis easier.